SGI Freeware 1999 August/SGI Freeware 1999 August.iso/dist/fw_ImageMagick.idb/usr/freeware/catman/u_man/cat1/display.Z/display

Text File | 1999-01-26 | 133.7 KB | 3,169 lines

     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



     NNNNAAAAMMMMEEEE
      display - display an image on    any workstation    running    X

     SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
      ddddiiiissssppppllllaaaayyyy [[[[ _o_p_t_i_o_n_s ............]]]] _f_i_l_e [    [ _o_p_t_i_o_n_s ...] _f_i_l_e ...]

     DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
      DDDDiiiissssppppllllaaaayyyy is a machine architecture independent    image
      processing and display program.  It can display an image on
      any workstation screen running an X server.  DDDDiiiissssppppllllaaaayyyy can
      read and write many of the more popular image    formats    (e.g.
      JPEG,    TIFF, PNM, Photo CD, etc.).  With ddddiiiissssppppllllaaaayyyy, you can
      perform these    functions on an    image:

          o    load an    image from a file
          o    display    the next image
          o    display    the former image
          o    display    a sequence of images as    a slide    show
          o    write the image    to a file
          o    print the image    to a Postscript    printer
          o    delete the image file
          o    create a Visual    Image Directory
          o    select the image to display by its thumbnail rather
      than name
          o    copy a region of the image
          o    paste a    region to the image
          o    undo last image    transformation
          o    half the image size
          o    double the image size
          o    resize the image
          o    restore    the image to its original size
          o    refresh    the image
          o    crop the image
          o    cut the    image
          o    flop image in the horizontal direction
          o    flip image in the vertical direction
          o    rotate the image 90 degrees clockwise
          o    rotate the image 90 degrees counter-clockwise
          o    rotate the image
          o    shear the image
          o    trim the image edges
          o    invert the colors of the image
          o    vary the color brightness
          o    vary the color saturation
          o    vary the image hue
          o    gamma correct the image
          o    sharpen    the image contrast
          o    dull the image contrast
          o    perform    histogram equalization on the image
          o    perform    histogram normalization    on the image
          o    negate the image colors
          o    convert    the image to grayscale



     Page 1                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



          o    set the    maximum    number of unique colors    in the image
          o    reduce the speckles within an image
          o    eliminate peak noise from an image
          o    detect edges within the    image
          o    emboss an image
          o    segment    the image by color
          o    simulate an oil    painting
          o    simulate a charcoal drawing
          o    annotate the image with    text
          o    draw on    the image
          o    edit an    image pixel color
          o    edit the image matte information
          o    composite an image with    another
          o    add a border to    the image
          o    surround image with an ornamental border
          o    add an image comment
          o    apply image processing techniques to a region of
      interest
          o    display    information about the image
          o    show a histogram of the    image
          o    display    image to background of a window
          o    set user preferences
          o    display    information about this program
          o    discard    all images and exit program
          o    change the level of magnification
          o    display    images specified by a World Wide Web (WWW)
      uniform resource locator (URL)

     EEEEXXXXAAAAMMMMPPPPLLLLEEEESSSS
      To scale an image of a cockatoo to exactly 640 pixels    in
      width    and 480    pixels in height and position the window at
      location (200,200), use:

           display -geometry 640x480+200+200! cockatoo.miff

      To display an    image of a cockatoo without a border centered
      on a backdrop, use:

           display +borderwidth -backdrop cockatoo.miff

      To tile a slate texture onto the root    window,    use:

           display -size 1280x1024 -window root slate.png

      To display a visual image directory of all your JPEG images,
      use:

           display 'vid:*.jpg'

      To display a MAP image that is 640 pixels in width and 480
      pixels in height with    256 colors, use:




     Page 2                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



           display -size 640x480+256 cockatoo.map

      To display an    image of a cockatoo specified with a World
      Wide Web (WWW) uniform resource locator (URL), use

           display ftp://wizards.dupont.com/images/cockatoo.jpg

     OOOOPPPPTTTTIIIIOOOONNNNSSSS
      ----bbbbaaaacccckkkkddddrrrroooopppp
           display the image centered on a backdrop.

           This backdrop covers the    entire workstation screen and
           is useful for hiding other X window activity while
           viewing the image.   The    color of the backdrop is
           specified as the    background color.  Refer to XXXX
           RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS for details.

      ----bbbboooorrrrddddeeeerrrr <_w_i_d_t_h>_x<_h_e_i_g_h_t>
           surround    the image with a border    of color.  See XXXX((((1111))))
           for details about the geometry specification.

           The color of the    border is obtained from    the X server
           and is defined as bbbboooorrrrddddeeeerrrrccccoooolllloooorrrr (class bbbboooorrrrddddeeeerrrrCCCCoooolllloooorrrr).  See
           XXXX((((1111)))) for    details.

      ----ccccoooolllloooorrrrmmmmaaaapppp _t_y_p_e
           the type    of colormap: SSSShhhhaaaarrrreeeedddd or PPPPrrrriiiivvvvaaaatttteeee.

           This option only    applies    when the default X server
           visual is _P_s_e_u_d_o_C_o_l_o_r or    _G_r_a_y_S_c_a_l_e.  Refer to ----vvvviiiissssuuuuaaaallll
           for more    details.  By default, a    shared colormap    is
           allocated.  The image shares colors with    other X
           clients.     Some image colors could be approximated,
           therefore your image may    look very different than
           intended.  Choose PPPPrrrriiiivvvvaaaatttteeee and the image colors appear
           exactly as they are defined.  However, other clients
           may go _t_e_c_h_n_i_c_o_l_o_r when the image colormap is
           installed.

      ----ccccoooolllloooorrrrssss _v_a_l_u_e
           preferred number    of colors in the image.

           The actual number of colors in the image    may be less
           than your request, but never more.  Note, this is a
           color reduction option.    Images with less unique    colors
           than specified with this    option will have any duplicate
           or unused colors    removed.  Refer    to qqqquuuuaaaannnnttttiiiizzzzeeee((((9999)))) for
           more details.

           Note, options ----ddddiiiitttthhhheeeerrrr, ----ccccoooolllloooorrrrssssppppaaaacccceeee, and ----ttttrrrreeeeeeeeddddeeeepppptttthhhh
           affect the color    reduction algorithm.




     Page 3                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      ----ccccoooolllloooorrrrssssppppaaaacccceeee _v_a_l_u_e
           the type    of colorspace: GGGGRRRRAAAAYYYY, OOOOHHHHTTTTAAAA, RRRRGGGGBBBB,    TTTTrrrraaaannnnssssppppaaaarrrreeeennnntttt,
           XXXXYYYYZZZZ, YYYYCCCCbbbbCCCCrrrr, YYYYIIIIQQQQ,    YYYYPPPPbbbbPPPPrrrr, YYYYUUUUVVVV, or CCCCMMMMYYYYKKKK.

           Color reduction,    by default, takes place    in the RGB
           color space.  Empirical evidence    suggests that
           distances in color spaces such as YUV or    YIQ correspond
           to perceptual color differences more closely than do
           distances in RGB    space.    These color spaces may give
           better results when color reducing an image.  Refer to
           qqqquuuuaaaannnnttttiiiizzzzeeee((((9999)))) for more details.

           The TTTTrrrraaaannnnssssppppaaaarrrreeeennnntttt color space behaves uniquely in that it
           preserves the matte channel of the image    if it exists.

           The ----ccccoooolllloooorrrrssss or ----mmmmoooonnnnoooocccchhhhrrrroooommmmeeee option is required for this
           option to take effect.

      ----ccccoooommmmmmmmeeeennnntttt _s_t_r_i_n_g
           annotate    an image with a    comment.

           By default, each    image is commented with    its file name.
           Use this    option to assign a specific comment to the
           image.  Optionally you can include the image filename,
           type, width, height, or scene number by embedding
           special format characters.  Embed %%%%ffff for    filename, %%%%dddd
           for directory, %%%%eeee for filename extention, %%%%tttt for    top of
           filename, %%%%mmmm for    magick,    %%%%wwww for width, %%%%hhhh for height,
           %%%%pppp for page number, %%%%ssss for scene    number,    %%%%bbbb for file
           size, or    \\\\nnnn for newline.     For example,

            -comment "%m:%f %wx%h"

           produces    an image comment of MMMMIIIIFFFFFFFF::::bbbbiiiirrrrdddd....mmmmiiiiffffffff 555511112222xxxx444488880000 for
           an image    titled bbbbiiiirrrrdddd....mmmmiiiiffffffff and whose width is 512    and
           height is 480.

           If the first character of _s_t_r_i_n_g    is @@@@, the image
           comment is read from a file titled by the remaining
           characters in the string.

      ----ccccoooommmmpppprrrreeeessssssss _t_y_p_e
           the type    of image compression: _N_o_n_e, _J_P_E_G, _L_Z_W,
           _R_u_n_l_e_n_g_t_h_E_n_c_o_d_e_d, or _Z_i_p.

           Use this    option with ----wwwwrrrriiiitttteeee to specify the the type of
           image compression.  See mmmmiiiiffffffff((((5555)))) for details.

           Specify ++++ccccoooommmmpppprrrreeeessssssss to store the binary image in an
           uncompressed format.  The default is the    compression
           type of the specified image file.




     Page 4                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      ----ccccoooonnnnttttrrrraaaasssstttt
           enhance or reduce the image contrast.

           This option enhances the    intensity differences between
           the lighter and darker elements of the image.  Use
           ----ccccoooonnnnttttrrrraaaasssstttt to enhance the    image or ++++ccccoooonnnnttttrrrraaaasssstttt to reduce
           the image contrast.

      ----ccccrrrroooopppp    <_w_i_d_t_h>{%}_x<_h_e_i_g_h_t>{%}{+-}<_x _o_f_f_s_e_t>{+-}<_y _o_f_f_s_e_t>
           preferred size and location of the cropped image.  See
           XXXX((((1111)))) for    details    about the geometry specification.

           To specify a percentage width or    height instead,    append
           %%%%.  For example to crop the image by ten    percent    on all
           sides of    the image, use ----ccccrrrroooopppp 11110000%%%%.

           Use cropping to apply image processing options to, or
           display,    a particular area of an    image.

           Use cropping to crop a particular area of an image.
           Use ----ccccrrrroooopppp 0000xxxx0000 to    trim edges that    are the    background
           color.  Add a x and y offset to leave a portion of the
           trimmed edges with the image.

           The equivalent X    resource for this option is
           ccccrrrrooooppppGGGGeeeeoooommmmeeeettttrrrryyyy (class CCCCrrrrooooppppGGGGeeeeoooommmmeeeettttrrrryyyy).  See XXXX RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS for
           details.

      ----ddddeeeellllaaaayyyy <_1/_1_0_0_t_h_s _o_f _a    _s_e_c_o_n_d>
           display the next    image after pausing.

           This option is useful when viewing several images in
           sequence.  _1/_1_0_0_t_h_s _o_f _a    _s_e_c_o_n_d must expire before the
           next image is displayed.     The default is    to display the
           image and wait until you    choose to display the next
           image or    terminate the program.

      ----ddddeeeennnnssssiiiittttyyyy <_w_i_d_t_h>_x<_h_e_i_g_h_t>
           vertical    and horizontal resolution in pixels of the
           image.

           This option specifies an    image density when decoding a
           Postscript or Portable Document page.  The default is
           the same    as the resolution of your X server (see
           xxxxddddppppyyyyiiiinnnnffffoooo((((1111))))).  This option is used in concert with
           ----ppppaaaaggggeeee.

      ----ddddeeeessssppppeeeecccckkkklllleeee
           reduce the speckles within an image.

      ----ddddiiiissssppppllllaaaayyyy _h_o_s_t:_d_i_s_p_l_a_y[._s_c_r_e_e_n]
           specifies the X server to contact; see XXXX((((1111)))).



     Page 5                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      ----ddddiiiissssppppoooosssseeee _m_e_t_h_o_d
           GIF disposal method.

           Here are    the valid methods:

            0      No disposal specified.
            1      Do not dispose.
            2      Restore to background    color.
            3      Restore to previous.

      ----ddddiiiitttthhhheeeerrrr
           apply Floyd/Steinberg error diffusion to    the image.

           The basic strategy of dithering is to trade intensity
           resolution for spatial resolution by averaging the
           intensities of several neighboring pixels.  Images
           which suffer from severe    contouring when    reducing
           colors can be improved with this    option.

           The ----ccccoooolllloooorrrrssss or ----mmmmoooonnnnoooocccchhhhrrrroooommmmeeee option is required for this
           option to take effect.

           Use ++++ddddiiiitttthhhheeeerrrr to render Postscript    without    text or
           graphic aliasing.

      ----eeeeddddggggeeee    _f_a_c_t_o_r
           detect edges with an image.  Specify _f_a_c_t_o_r as the
           percent enhancement (0.0    - 99.9%).

      ----eeeennnnhhhhaaaannnncccceeee
           apply a digital filter to enhance a noisy image.

      ----ffffiiiilllltttteeeerrrr _v_a_l_u_e
           use this    type of    filter when resizing an    image.

           Use this    option to affect the resizing operation    of an
           image (see ----ggggeeeeoooommmmeeeettttrrrryyyy).  Choose from these filters:

            Point
            Box
            Triangle
            Hermite
            Hanning
            Hamming
            Blackman
            Gaussian
            Quadratic
            Cubic
            Catrom
            Mitchell
            Lanczos
            Bessel



     Page 6                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



            Sinc

           The default filter is MMMMiiiittttcccchhhheeeellllllll.


      ----fffflllliiiipppp
           create a    "mirror    image" by reflecting the image
           scanlines in the    vertical direction.

      ----fffflllloooopppp
           create a    "mirror    image" by reflecting the image
           scanlines in the    horizontal direction.

      ----
           ffffrrrraaaammmmeeee <_w_i_d_t_h>_x<_h_e_i_g_h_t>+<_o_u_t_e_r _b_e_v_e_l _w_i_d_t_h>+<_i_n_n_e_r _b_e_v_e_l _w_i_d_t_h>
           surround    the image with an ornamental border.  See XXXX((((1111))))
           for details about the geometry specification.

           The color of the    border is specified with the
           ----mmmmaaaatttttttteeeeccccoooolllloooorrrr command line    option.

      ----ggggaaaammmmmmmmaaaa _v_a_l_u_e
           level of    gamma correction.

           The same    color image displayed on two different
           workstations may    look different due to differences in
           the display monitor.  Use gamma correction to adjust
           for this    color difference.  Reasonable values extend
           from 0.8    to 2.3.

           You can apply separate gamma values to the red, green,
           and blue    channels of the    image with a gamma value list
           delineated with slashes (i.e. 1.7/2.3/1.2).

           Use ++++ggggaaaammmmmmmmaaaa to set the image gamma level without
           actually    adjusting the image pixels.  This option is
           useful if the image is of a known gamma but not set as
           an image    attribute (e.g.    PNG images).

     _o_f_f_s_e_t>{!}{<}{>}
      ----ggggeeeeoooommmmeeeettttrrrryyyy <_w_i_d_t_h>{%}_x<_h_e_i_g_h_t>{%}{+-}<_x _o_f_f_s_e_t>{+-}<_y
           preferred size and location of the image    window.     See
           XXXX((((1111)))) for    details    about the geometry specification.  By
           default,    the window size    is the image size and the
           location    is chosen by you when it is mapped.

           By default, the width and height    are maximum values.
           That is,    the image is expanded or contracted to fit the
           width and height    value while maintaining    the aspect
           ratio of    the image.  Append an exclamation point    to the
           geometry    to force the image size    to exactly the size
           you specify.  For example, if you specify 666644440000xxxx444488880000!!!! the



     Page 7                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



           image width is set to 640 pixels    and height to 480.  If
           only one    factor is specified, both the width and    height
           assume the value.

           To specify a percentage width or    height instead,    append
           %%%%.  The image size is multiplied    by the width and
           height percentages to obtain the    final image
           dimensions.  To increase    the size of an image, use a
           value greater than 100 (e.g. 125%).  To decrease    an
           image's size, use a percentage less than    100.

           Use >>>> to    change the dimensions of the image _o_n_l_y    if its
           size exceeds the    geometry specification.     <<<< resizes the
           image _o_n_l_y if its dimensions is less than the geometry
           specification.  For example, if you specify 666644440000xxxx444488880000>>>>
           and the image size is 512x512, the image    size does not
           change.    However, if the    image is 1024x1024, it is
           resized to 640x480.

           When displaying an image    on an X    server,    <_x _o_f_f_s_e_t> and
           <_y _o_f_f_s_e_t> is relative to the root window.

           The equivalent X    resource for this option is ggggeeeeoooommmmeeeettttrrrryyyy
           (class GGGGeeeeoooommmmeeeettttrrrryyyy).  See XXXX    RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS for details.

      ----iiiinnnntttteeeerrrrllllaaaacccceeee _t_y_p_e
           the type    of interlacing scheme: NNNNoooonnnneeee, LLLLiiiinnnneeee, PPPPllllaaaannnneeee, or
           PPPPaaaarrrrttttiiiittttiiiioooonnnn.  The default is NNNNoooonnnneeee.

           This option is used to specify the type of interlacing
           scheme for raw image formats such as RRRRGGGGBBBB    or YYYYUUUUVVVV.     NNNNoooo
           means do    not interlace (RGBRGBRGBRGBRGBRGB...), LLLLiiiinnnneeee
           uses scanline interlacing
           (RRR...GGG...BBB...RRR...GGG...BBB...), and PPPPllllaaaannnneeee uses
           plane interlacing (RRRRRR...GGGGGG...BBBBBB...).
           PPPPaaaarrrrttttiiiittttiiiioooonnnn is like plane except the different planes are
           saved to    individual files (e.g.    image.R, image.G, and
           image.B).

           Use LLLLiiiinnnneeee, or PPPPllllaaaannnneeee to create an interlaced GIF or
           progressive JPEG    image.

      ----iiiimmmmmmmmuuuuttttaaaabbbblllleeee
           displayed image cannot be modified",

      ----llllaaaabbbbeeeellll _s_t_r_i_n_g
           assign a    label to an image.

           Use this    option to assign a specific label to the
           image.  Optionally you can include the image filename,
           type, width, height, or scene number in the label by
           embedding special format    characters.   Embed %%%%ffff for



     Page 8                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



           filename, %%%%dddd for    directory, %%%%eeee for filename extention,
           %%%%tttt for top of filename, %%%%mmmm for magick, %%%%wwww for width, %%%%hhhh
           for height, %%%%pppp for page number, %%%%ssss for scene number, %%%%bbbb
           for file    size in    kilobytes, or \\\\nnnn for newline.  For
           example,

            -label "%m:%f %wx%h"

           produces    an image label of MMMMIIIIFFFFFFFF::::bbbbiiiirrrrdddd....mmmmiiiiffffffff 555511112222xxxx444488880000 for
           an image    titled bbbbiiiirrrrdddd....mmmmiiiiffffffff and whose width is 512    and
           height is 480.

           If the first character of _s_t_r_i_n_g    is @@@@, the image    label
           is read from a file titled by the remaining characters
           in the string.

           When converting to Postscript, use this option to
           specify a header    string to print    above the image.
           Specify the label font with ----ffffoooonnnntttt.

      ----mmmmaaaapppp _t_y_p_e
           display image using this    Standard Colormap type.

           Choose from these Standard Colormap types:

           best
           default
           gray
           red
           green
           blue

           The X server must support the Standard Colormap you
           choose, otherwise an error occurs.  Use lllliiiisssstttt as the
           type and    ddddiiiissssppppllllaaaayyyy((((1111)))) searches the    list of    colormap types
           in top-to-bottom    order until one    is located. See
           xxxxssssttttddddccccmmmmaaaapppp((((1111)))) for one way of creating Standard Colormaps.

      ----mmmmaaaatttttttteeee
           store matte channel if the image    has one    otherwise
           create an opaque    one.

      ----mmmmoooonnnnoooocccchhhhrrrroooommmmeeee
           transform the image to black and    white.

      ----nnnneeeeggggaaaatttteeee
           apply color inversion to    image.

           The red,    green, and blue    intensities of an image    are
           negated.      Use ++++nnnneeeeggggaaaatttteeee to only negate the grayscale
           pixels of the image.




     Page 9                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      ----ppppaaaaggggeeee    <_w_i_d_t_h>{%}_x<_h_e_i_g_h_t>{%}{+-}<_x _o_f_f_s_e_t>{+-
           }<_y _o_f_f_s_e_t>{!}{<}{>}
           preferred size and location of an image canvas.

           Use this    option to specify the dimensions of the
           Postscript page in dots per inch    or a TEXT page in
           pixels.    The choices for    a Postscript page are:

           Letter      612x 792
           Tabloid     792x1224
           Ledger     1224x 792
           Legal       612x1008
           Statement   396x 612
           Executive   540x 720
           A3           842x1190
           A4           595x 842
           A5           420x 595
           B4           729x1032
           B5           516x 729
           Folio       612x 936
           Quarto      610x 780
           10x14       720x1008

           For convenience you can specify the page    size by    media
           (e.g.  A4, Ledger, etc.).  Otherwise, ----ppppaaaaggggeeee behaves
           much like ----ggggeeeeoooommmmeeeettttrrrryyyy (e.g. -page letter+43+43>).

           To position a GIF image,    use -page {+-}<_x _o_f_f_s_e_t>{+-}<_y
           _o_f_f_s_e_t> (e.g. -page +100+200).

           For a Postscript    page, the image    is sized as in
           ----ggggeeeeoooommmmeeeettttrrrryyyy and positioned    relative to the    lower left
           hand corner of the page by {+-}<_x _o_f_f_s_e_t>{+-}<_y
           _o_f_f_s_e_t>.     Use -page 612x792>, for example, to center
           the image within    the page.  If the image    size exceeds
           the Postscript page, it is reduced to fit the page.

           The default page    dimensions for a TEXT image is
           612x792.

           This option is used in concert with ----ddddeeeennnnssssiiiittttyyyy.

      ----qqqquuuuaaaalllliiiittttyyyy _v_a_l_u_e
           JPEG/MIFF/PNG compression level.

           For the JPEG image format, quality is 0 (worst) to 100
           (best).    The default quality is 75.

           Quality for the MIFF and    PNG image format sets the
           amount of image compression (quality / 10) and filter-
           type (quality % 10).  Compression quality values    range
           from 0 (worst) to 100 (best).  If filter-type is    4 or



     Page 10                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



           less, the specified filter-type is used for all
           scanlines:

           0: none
           1: sub
           2: up
           3: average
           4: Paeth

           If filter-type is 5, adaptive filtering is used when
           quality is greater than 50 and the image    does not have
           a color map, otherwise no filtering is used.

           If filter-type is 6 or more, adaptive filtering with
           _m_i_n_i_m_u_m-_s_u_m-_o_f-_a_b_s_o_l_u_t_e-_v_a_l_u_e_s is used.

           The default is quality is 75.  Which means nearly the
           best compression    with adaptive filtering.

           For further information,    see the    PNG specification (RFC
           2083), <http://www.w3.org/pub/WWW/TR>.

      ----rrrraaaaiiiisssseeee <_w_i_d_t_h>_x<_h_e_i_g_h_t>
           lighten or darken image edges to    create a 3-D effect.
           See XXXX((((1111))))    for details about the geometry specification.

           Use ----rrrraaaaiiiisssseeee to create a raised effect, otherwise use
           ++++rrrraaaaiiiisssseeee.

      ----rrrreeeemmmmooootttteeee _s_t_r_i_n_g
           execute a command in an remote display process.

           The only    command    recognized at this time    is the name of
           an image    file to    load.

      ----rrrroooollllllll    {+-}<_x _o_f_f_s_e_t>{+-}<_y _o_f_f_s_e_t>
           roll an image vertically    or horizontally.  See XXXX((((1111)))) for
           details about the geometry specification.

           A negative _x _o_f_f_s_e_t rolls the image left-to-right.  A
           negative    _y _o_f_f_s_e_t rolls the image top-to-bottom.

      ----rrrroooottttaaaatttteeee _d_e_g_r_e_e_s{<}{>}
           apply Paeth image rotation to the image.

           Use >>>> to    rotate the image _o_n_l_y if its width exceeds the
           height.    <<<< rotates the image _o_n_l_y if its    width is less
           than the    height.     For example, if you specify ----99990000>>>> and
           the image size is 480x640, the image is not rotated by
           the specified angle.  However, if the image is 640x480,
           it is rotated by    -90 degrees.




     Page 11                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



           Empty triangles left over from rotating the image are
           filled with the color defined as    bbbboooorrrrddddeeeerrrrccccoooolllloooorrrr (class
           bbbboooorrrrddddeeeerrrrCCCCoooolllloooorrrr).

      ----ssssaaaammmmpppplllleeee _g_e_o_m_e_t_r_y
           scale image with    pixel sampling.     See ----ggggeeeeoooommmmeeeettttrrrryyyy for
           details about the geometry specification.

      ----sssscccceeeennnneeee _v_a_l_u_e
           image scene number.

           Use this    option to specify an image sequence with a
           single filename.     See the discussion of _f_i_l_e below for
           details.

      ----sssseeeeggggmmmmeeeennnntttt _v_a_l_u_e
           eliminate clusters that are insignificant.

           The number of pixels in each cluster must exceed    the
           the cluster threshold to    be considered valid.

           See IIIIMMMMAAAAGGGGEEEE SSSSEEEEGGGGMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN ffffoooorrrr ddddeeeettttaaaaiiiillllssss....

      ----sssshhhhaaaarrrrppppeeeennnn _f_a_c_t_o_r
           sharpen an image.  Specify _f_a_c_t_o_r as the    percent
           enhancement (0.0    - 99.9%).

      ----ssssiiiizzzzeeee    <_w_i_d_t_h>{%}_x<_h_e_i_g_h_t>{%}+<_o_f_f_s_e_t>
           width and height    of the image.

           Use this    option to specify the width and    height of raw
           images whose dimensions are unknown such    as GGGGRRRRAAAAYYYY, RRRRGGGGBBBB,
           or CCCCMMMMYYYYKKKK.     In addition to    width and height, use ----ssssiiiizzzzeeee to
           skip any    header information in the image    or tell    the
           number of colors    in a MMMMAAAAPPPP image file, (e.g. -size
           640x512+256).

           For Photo CD images, choose from    these sizes:

             192x128
             384x256
             768x512
            1536x1024
            3072x2048

           Finally,    use this option    to choose a particular
           resolution layer    of a JBIG or JPEG image    (e.g. -size
           1024x768).

      ----tttteeeexxxxttttuuuurrrreeee _f_i_l_e_n_a_m_e
           name of texture to tile onto the    image background.




     Page 12                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      ----ttttiiiittttlllleeee _s_t_r_i_n_g
           assign a    title to the displayed image.

           Use this    option to assign a specific title to the
           image.  This is assigned    to the image window and    is
           typically displayed in the window title bar.
           Optionally you can include the image filename, type,
           width, height, or scene number in the label by
           embedding special format    characters.   Embed %%%%ffff for
           filename, %%%%dddd for    directory, %%%%eeee for filename extention,
           %%%%tttt for top of filename, %%%%mmmm for magick, %%%%wwww for width, %%%%hhhh
           for height, %%%%pppp for page number, %%%%ssss for scene number, or
           %%%%bbbb for file size    in kilobytes.  For example,

            -title "%m:%f %wx%h"

           produces    an image title of MMMMIIIIFFFFFFFF::::bbbbiiiirrrrdddd....mmmmiiiiffffffff 555511112222xxxx444488880000 for
           an image    titled bbbbiiiirrrrdddd....mmmmiiiiffffffff and whose width is 512    and
           height is 480.

      ----ttttrrrreeeeeeeeddddeeeepppptttthhhh _v_a_l_u_e
           Normally, this integer value is zero or one.  A zero or
           one tells ddddiiiissssppppllllaaaayyyy to choose a optimal tree depth    for
           the color reduction algorithm.

           An optimal depth    generally allows the best
           representation of the source image with the fastest
           computational speed and the least amount    of memory.
           However,    the default depth is inappropriate for some
           images.    To assure the best representation, try values
           between 2 and 8 for this    parameter.  Refer to
           qqqquuuuaaaannnnttttiiiizzzzeeee((((9999)))) for more details.

           The ----ccccoooolllloooorrrrssss or ----mmmmoooonnnnoooocccchhhhrrrroooommmmeeee option is required for this
           option to take effect.

      ----uuuuppppddddaaaatttteeee _s_e_c_o_n_d_s
           detect when image file is modified and redisplay.

           Suppose that while you are displaying an    image the file
           that is currently displayed is over-written.  ddddiiiissssppppllllaaaayyyy
           will automatically detect that the input    file has been
           changed and update the displayed    image accordingly.

      ----vvvveeeerrrrbbbboooosssseeee
           print detailed information about    the image.

           This information    is printed: image scene    number;     image
           name;  image size; the image class (_D_i_r_e_c_t_C_l_a_s_s or
           _P_s_e_u_d_o_C_l_a_s_s);  the total    number of unique colors;  and
           the number of seconds to    read and transform the image.
           Refer to    mmmmiiiiffffffff((((5555))))    for a description of the image class.



     Page 13                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



           If ----ccccoooolllloooorrrrssss is also specified, the total unique colors
           in the image and    color reduction    error values are
           printed.     Refer to qqqquuuuaaaannnnttttiiiizzzzeeee((((9999)))) for a description    of
           these values.

      ----vvvviiiissssuuuuaaaallll _t_y_p_e
           display image using this    visual type.

           Choose from these visual    classes:

            StaticGray
            GrayScale
            StaticColor
            PseudoColor
            TrueColor
            DirectColor
            default
            _v_i_s_u_a_l _i_d

           The X server must support the visual you    choose,
           otherwise an error occurs.  If a    visual is not
           specified, the visual class that    can display the    most
           simultaneous colors on the default X server screen is
           chosen.

      ----wwwwiiiinnnnddddoooowwww _i_d
           set the background pixmap of this window    to the image.

           _i_d can be a window id or    name.  Specify rrrrooooooootttt to select
           X's root    window as the target window.

           By default the image is tiled onto the background of
           the target window.   If ----bbbbaaaacccckkkkddddrrrroooopppp or ----ggggeeeeoooommmmeeeettttrrrryyyy are
           specified, the image is surrounded by the background
           color.  Refer to    XXXX RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS for    details.

           The image will not display on the root window if    the
           image has more unique colors than the target window
           colormap    allows.     Use ----ccccoooolllloooorrrrssss to    reduce the number of
           colors.    ----wwwwiiiinnnnddddoooowwww____ggggrrrroooouuuupppp _i_d exit program when this    window
           id is destroyed.

           _i_d can be a window id or    name.

      ----wwwwrrrriiiitttteeee _f_i_l_e_n_a_m_e
           write image to a    file.

           If _f_i_l_e already exists, you will    be prompted as to
           whether it should be overwritten.

           By default, the image is    written    in the format that it
           was read    in as.    To specify a particular    image format,



     Page 14                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



           prefix _f_i_l_e with    the image type and a colon (i.e.
           ps:image) or specify the    image type as the filename
           suffix (i.e. image.ps).    See ccccoooonnnnvvvveeeerrrrtttt((((1111)))) for a list of
           valid image formats.  Specify _f_i_l_e as - for standard
           output.    If _f_i_l_e    has the    extension ....ZZZZ or    ....ggggzzzz, the file
           size is compressed using    with ccccoooommmmpppprrrreeeessssssss or ggggzzzziiiipppp
           respectively.  Precede the image    file name | to pipe to
           a system    command. If _f_i_l_e already exists, you will be
           prompted    as to whether it should    be overwritten.

           Use ----ccccoooommmmpppprrrreeeessssssss to    specify    the type of image compression.

           The equivalent X    resource for this option is
           wwwwrrrriiiitttteeeeFFFFiiiilllleeeennnnaaaammmmeeee (class WWWWrrrriiiitttteeeeFFFFiiiilllleeeennnnaaaammmmeeee).  See XXXX RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
           for details.

      In addition to those listed above, you can specify these
      standard X resources as command line options:     ----bbbbaaaacccckkkkggggrrrroooouuuunnnndddd,
      ----bbbboooorrrrddddeeeerrrrccccoooolllloooorrrr,    ----bbbboooorrrrddddeeeerrrrwwwwiiiiddddtttthhhh, ----ffffoooonnnntttt, ----ffffoooorrrreeeeggggrrrroooouuuunnnndddd,
      ----iiiiccccoooonnnnGGGGeeeeoooommmmeeeettttrrrryyyy, ----iiiiccccoooonnnniiiicccc, ----mmmmaaaatttttttteeeeccccoooolllloooorrrr, ----nnnnaaaammmmeeee, or ----ttttiiiittttlllleeee.  See
      XXXX RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS for details.

      Options are processed    in command line    order.    Any option you
      specify on the command line remains in effect    until it is
      explicitly changed by    specifying the option again with a
      different effect.  For example to display two    images,    the
      first    with 32    colors,    and the    second with only 16 colors,
      use:

           display -colors 32 cockatoo.miff    -colors    16 macaw.miff

      By default, the image    format is determined by    its magic
      number. To specify a particular image    format,    precede    the
      filename with    an image format    name and a colon (i.e.
      ps:image) or specify the image type as the filename suffix
      (i.e.    image.ps).  See    ccccoooonnnnvvvveeeerrrrtttt((((1111)))) for a list of valid image
      formats.

      When you specify XXXX as    your image type, the filename has
      special meaning.  It specifies an X window by    id, name, or
      rrrrooooooootttt.     If no filename    is specified, the window is selected
      by clicking the mouse    in the desired window.

      Specify _f_i_l_e as - for    standard input.     If _f_i_l_e has the
      extension ....ZZZZ or ....ggggzzzz, the file    is uncompressed    with
      uuuunnnnccccoooommmmpppprrrreeeessssssss or    gggguuuunnnnzzzziiiipppp respectively.  Precede the image    file
      name | to pipe from a    system command.

      Use an optional index    enclosed in brackets after a file name
      to specify a desired subimage    of a multi-resolution image
      format like Photo CD (e.g. img0001.pcd[4]) or    a range    for
      MPEG images (e.g. video.mpg[50-75]).    A subimage



     Page 15                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      specification    can be disjoint    (e.g. image.tiff[2,7,4]).  For
      raw images, specify a    subimage with a    geometry (e.g.    -size
      640x512 image.rgb[320x256+50+50]).

      Single images    are read with the filename you specify.
      Alternatively, you can display an image sequence with    a
      single filename.  Define the range of    the image sequence
      with -_s_c_e_n_e.    Each image in the range    is read    with the
      filename followed by a period    (....)  and the scene number.
      You can change this behavior by embedding a pppprrrriiiinnnnttttffff format
      specification    in the file name.  For example,

           -scene 0-9 image%02d.miff

      displays files image00.miff, image01.miff, through
      image09.miff.

     BBBBUUUUTTTTTTTTOOOONNNNSSSS
      The effects of each button press is described    below.    Three
      buttons are required.     If you    have a two button mouse,
      button 1 and 3 are returned.    Press ALT and button 3 to
      simulate button 2.

      1111    Press this button to map    or unmap the Command widget.
           See the next section for    more information about the
           Command widget.

      2222    Press and drag to define    a region of the    image to
           magnify.

      3333    Press and drag to choose    from a select set of
           ddddiiiissssppppllllaaaayyyy((((1111)))) commands.  This button behaves differently
           if the image being displayed is a visual    image
           directory.  Here, choose    a particular tile of the
           directory and press this    button and drag    to select a
           command from a pop-up menu.  Choose from    these menu
           items:

           Open
           Next
           Former
           Delete
           Update

           If you choose OOOOppppeeeennnn, the image represented by the    tile
           is displayed.  To return    to the visual image directory,
           choose NNNNeeeexxxxtttt from    the Command widget (refer to COMMAND
           WIDGET).     NNNNeeeexxxxtttt and FFFFoooorrrrmmmmeeeerrrr moves to the next or former
           image respectively.  Choose DDDDeeeelllleeeetttteeee to delete a
           particular image    tile.  Finally,    choose UUUUppppddddaaaatttteeee to
           synchronize all the image tiles with their respective
           images.    See mmmmoooonnnnttttaaaaggggeeee((((1111)))) and mmmmiiiiffffffff((((5555)))) for more details.



     Page 16                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



     CCCCOOOOMMMMMMMMAAAANNNNDDDD WWWWIIIIDDDDGGGGEEEETTTT
      The Command widget lists a number of sub-menus and commands.
      They are

          File
        Open...
        Next
        Former
        Select...
        Save...
        Print...
        Delete...
        Canvas...
        Visual Directory...
        Quit
          Edit
        Undo
        Redo
        Cut
        Copy
        Paste
          View
        Half Size
        Original Size
        Double Size
        Resize...
        Apply
        Refresh
        Restore
          Transform
        Crop
        Chop
        Flop
        Flip
        Rotate Right
        Rotate Left
        Rotate...
        Shear...
        Roll...
        Trim Edges
          Enhance
        Hue...
        Saturation...
        Brightness...
        Gamma...
        Spiff...
        Dull
        Equalize
        Normalize
        Negate
        Grayscale
        Map...



     Page 17                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



        Quantize...
          Effects
        Despeckle
        Emboss
        Reduce Noise
        Add Noise
        Sharpen...
        Blur...
        Threshold...
        Edge Detect...
        Spread...
        Shade...
        Raise...
        Segment...
          F/X
        Solarize...
        Swirl...
        Implode...
        Wave...
        Oil Painting...
        Charcoal Drawing...
          Image Edit
        Annotate...
        Draw...
        Color...
        Matte...
        Composite...
        Add Border...
        Add Frame...
        Comment...
        Launch...
        Region of Interest...
          Miscellany
        Image Info
        Zoom Image
        Show Preview...
        Show Histogram
        Show Matte
        Background...
        Slide Show
        Preferences...
          Help
        Help
        Browse Documentation
        About Display

      Menu items with a indented triangle have a sub-menu.    They
      are represented above    as the indented    items.    To access a
      sub-menu item, move the pointer to the appropriate menu and
      press    button 1 and drag.  When you find the desired sub-menu
      item,    release    the button and the command is executed.     Move
      the pointer away from    the sub-menu if    you decide not to



     Page 18                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      execute a particular command.

     KKKKEEEEYYYYBBBBOOOOAAAARRRRDDDD AAAACCCCCCCCEEEELLLLEEEERRRRAAAATTTTOOOORRRRSSSS
      Accelerators are one or two key presses that effect a
      particular command.  The keyboard accelerators that
      ddddiiiissssppppllllaaaayyyy((((1111)))) understands is:

      CCCCttttllll++++OOOO
           Press to    load an    image from a file.

           Refer to    IIIIMMMMAAAAGGGGEEEE LLLLOOOOAAAADDDDIIIINNNNGGGG for more details.

      ssssppppaaaacccceeee
           Press to    display    the next image.

           If the image is a multi-paged document such as a
           Postscript document, you    can skip ahead several pages
           by preceeding this command with a number.  For example
           to display the fourth page beyond the current page,
           press 4444ssssppppaaaacccceeee.

      bbbbaaaacccckkkkssssppppaaaacccceeee
           Press to    display    the former image.

           If the image is a multi-paged document such as a
           Postscript document, you    can skip behind    several    pages
           by preceeding this command with a number.  For example
           to display the fourth page preceeding the current page,
           press 4444nnnn.

      CCCCttttllll++++SSSS
           Press to    save the image to a file.

      CCCCttttllll++++PPPP
           Press to    print the image    to a Postscript    printer.

      CCCCttttllll++++DDDD
           Press to    delete an image    file.

      CCCCttttllll++++NNNN
           Press to    create a blank canvas.

      CCCCttttllll++++QQQQ
           Press to    discard    all images and exit program.

      CCCCttttllll++++ZZZZ
           Press to    undo last image    transformation.

      CCCCttttllll++++RRRR
           Press to    redo last image    transformation.

      CCCCttttllll++++XXXX



     Page 19                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



           Press to    cut a region of    the image.

           Refer to    IIIIMMMMAAAAGGGGEEEE CCCCUUUUTTTTTTTTIIIINNNNGGGG for more details.

      CCCCttttllll++++CCCC
           Press to    copy a region of the image.

           Refer to    IIIIMMMMAAAAGGGGEEEE CCCCOOOOPPPPYYYYIIIINNNNGGGG for more details.

      CCCCttttllll++++VVVV
           Press to    paste a    region to the image.

           Refer to    IIIIMMMMAAAAGGGGEEEE PPPPAAAASSSSTTTTIIIINNNNGGGG for more details.

      <<<<    Press to    half the image size.

      ----    Press to    return to the original image size.

      >>>>    Press to    double the image size.

      %%%%    Press to    resize the image to a width and    height you
           specify.

      CCCCmmmmdddd----AAAA
           Press to    make any image transformations permanent.

           By default, any image size transformations are applied
           to the original image to    create the image displayed on
           the X server.  However, the transformations are not
           permanent (i.e. the original image does not change size
           only the    X image    does).    For example, if    you press >>>>
           the X image will    appear to double in size, but the
           original    image will in fact remain the same size.  To
           force the original image    to double in size, press >>>>
           followed    by AAAA.

      @@@@    Press to    refresh    the image window.

      CCCC    Press to    crop the image.

           Refer to    IIIIMMMMAAAAGGGGEEEE CCCCRRRROOOOPPPPPPPPIIIINNNNGGGG for more    details.

      [[[[    Press to    chop the image.

           Refer to    IIIIMMMMAAAAGGGGEEEE CCCCHHHHOOOOPPPPPPPPIIIINNNNGGGG for more    details.

      HHHH    Press to    flop image in the horizontal direction.

      VVVV    Press to    flip image in the vertical direction.

      ////    Press to    rotate the image 90 degrees clockwise.




     Page 20                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      PPPPrrrreeeessssssss    ttttoooo rrrroooottttaaaatttteeee tttthhhheeee iiiimmmmaaaaggggeeee 99990000 ddddeeeeggggrrrreeeeeeeessss ccccoooouuuunnnntttteeeerrrr----cccclllloooocccckkkkwwwwiiiisssseeee....

      ****    Press to    rotate the image the number of degrees you
           specify.

           Refer to    IIIIMMMMAAAAGGGGEEEE RRRROOOOTTTTAAAATTTTIIIIOOOONNNN for more    details.

      ssss    Press to    shear the image    the number of degrees you
           specify.

      rrrr    Press to    roll the image.

      tttt    Press to    trim the image edges.

      SSSShhhhfffftttt----HHHH
           Press to    vary the color hue.

      SSSShhhhfffftttt----SSSS
           Press to    vary the color saturation.

      SSSShhhhfffftttt----LLLL
           Press to    vary the image brightness.

      SSSShhhhfffftttt----GGGG
           Press to    gamma correct the image.

      SSSShhhhfffftttt----CCCC
           Press to    spiff up the image contrast.

      SSSShhhhfffftttt----ZZZZ
           Press to    dull the image contrast.

      ====    Press to    perform    histogram equalization on the image.

      SSSShhhhfffftttt----NNNN
           Press to    perform    histogram normalization    on the image.

      ~~~~    Press to    negate the colors of the image.

      ....    Press to    convert    the image colors to gray.

      ####    Press to    set the    maximum    number of unique colors    in the
           image.

      FFFF2222   Press to    reduce the speckles in an image.

      FFFF3333   Press to    emboss an image.

      FFFF4444   Press to    eliminate peak noise from an image.

      FFFF5555   Press to    add noise to an    image.




     Page 21                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      FFFF6666   Press to    sharpen    an image.

      FFFF7777   Press to    blur image an image.

      FFFF8888   Press to    threshold the image.

      FFFF9999   Press to    detect edges within an image.

      FFFF11110000  Press to    displace pixels    by a random amount.

      FFFF11111111  Press to    shade the image    using a    distant    light source.

      FFFF11112222  Press to    lighten    or darken image    edges to create    a 3-D
           effect.

      FFFF11113333  Press to    segment    the image by color.

      MMMMeeeettttaaaa----SSSS
           Press to    swirl image pixels about the center.

      MMMMeeeettttaaaa----IIII
           Press to    implode    image pixels about the center.

      MMMMeeeettttaaaa----WWWW
           Press to    alter an image along a sine wave.

      MMMMeeeettttaaaa----PPPP
           Press to    simulate an oil    painting.

      MMMMeeeettttaaaa----CCCC
           Press to    simulate a charcoal drawing.

      AAAAlllltttt----AAAA
           Press to    annotate the image with    text.

           Refer to    IIIIMMMMAAAAGGGGEEEE AAAANNNNNNNNOOOOTTTTAAAATTTTIIIIOOOONNNN for more details.

      AAAAlllltttt----DDDD
           Press to    draw a line on the image.

           Refer to    IIIIMMMMAAAAGGGGEEEE DDDDRRRRAAAAWWWWIIIINNNNGGGG for more details.

      AAAAlllltttt----PPPP
           Press to    edit an    image pixel color.

           Refer to    CCCCOOOOLLLLOOOORRRR EEEEDDDDIIIITTTTIIIINNNNGGGG for more details.

      AAAAlllltttt----MMMM
           Press to    edit the image matte information.

           Refer to    MMMMAAAATTTTTTTTEEEE EEEEDDDDIIIITTTTIIIINNNNGGGG for more details.




     Page 22                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      AAAAlllltttt----VVVV
           Press to    composite the image with another.

           Refer to    IIIIMMMMAAAAGGGGEEEE CCCCOOOOMMMMPPPPOOOOSSSSIIIITTTTIIIINNNNGGGG for more details.

      AAAAlllltttt----BBBB
           Press to    add a border to    the image.

      AAAAlllltttt----FFFF
           Press to    add a ornamental frame to the image.

      SSSShhhhfffftttt----!!!!
           Press to    add an image comment.

      CCCCttttllll----AAAA
           Press to    apply an image processing technique to a
           region of interest.

           Refer to    RRRREEEEGGGGIIIIOOOONNNN OOOOFFFF IIIINNNNTTTTEEEERRRREEEESSSSTTTT for more details.

      SSSShhhhfffftttt----????
           Press to    display    information about the image.

      SSSShhhhfffftttt----++++
           Press to    map the    zoom image window.

      SSSShhhhfffftttt----PPPP
           Press to    preview    an image enhancement, effect, or f/x.

      FFFF1111   Press to    display    helpful    information about ddddiiiissssppppllllaaaayyyy((((1111)))).

      FFFFiiiinnnndddd Press to    browse documentation about IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk.

      1111----9999  Press to    change the level of magnification.

           Use the arrow keys to move the image one    pixel up,
           down, left, or right within the magnify window.    Be
           sure to first map the magnify window by pressing    button
           2.

           Press AAAALLLLTTTT and one of the    arrow keys to trim off one
           pixel from any side of the image.

     XXXX RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS
      DDDDiiiissssppppllllaaaayyyy options can appear on    the command line or in your X
      resource file.  Options on the command line supersede    values
      specified in your X resource file.  See XXXX((((1111)))) for more
      information on X resources.

      Most ddddiiiissssppppllllaaaayyyy options have a corresponding X resource.     In
      addition, ddddiiiissssppppllllaaaayyyy uses the following X resources:




     Page 23                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      bbbbaaaacccckkkkggggrrrroooouuuunnnndddd ((((_c_l_a_s_s BBBBaaaacccckkkkggggrrrroooouuuunnnndddd))))
           Specifies the preferred color to    use for    the image
           window background.  The default is #ccc.

      bbbboooorrrrddddeeeerrrrCCCCoooolllloooorrrr ((((_c_l_a_s_s BBBBoooorrrrddddeeeerrrrCCCCoooolllloooorrrr))))
           Specifies the preferred color to    use for    the image
           window border.  The default is #ccc.

      bbbboooorrrrddddeeeerrrrWWWWiiiiddddtttthhhh ((((_c_l_a_s_s BBBBoooorrrrddddeeeerrrrWWWWiiiiddddtttthhhh))))
           Specifies the width in pixels of    the image window
           border.    The default is 2.

      bbbbrrrroooowwwwsssseeeeCCCCoooommmmmmmmaaaannnndddd    ((((_c_l_a_s_s bbbbrrrroooowwwwsssseeeeCCCCoooommmmmmmmaaaannnndddd))))
           Specifies the name of the preferred browser when
           displaying ImageMagick documentation.  The default is
           nnnneeeettttssssccccaaaappppeeee    %%%%ssss.

      ccccoooonnnnffffiiiirrrrmmmmEEEExxxxiiiitttt ((((_c_l_a_s_s CCCCoooonnnnffffiiiirrrrmmmmEEEExxxxiiiitttt))))
           DDDDiiiissssppppllllaaaayyyy pops up a dialog    box to confirm exiting the
           program when exiting the    program.  Set this resource to
           _F_a_l_s_e to    exit without a confirmation.

      ddddiiiissssppppllllaaaayyyyGGGGaaaammmmmmmmaaaa ((((_c_l_a_s_s DDDDiiiissssppppllllaaaayyyyGGGGaaaammmmmmmmaaaa))))
           Specifies the gamma of your X server.

           You can apply separate gamma values to the red, green,
           and blue    channels of the    image with a gamma value list
           delineated with slashes (i.e. 1.7/2.3/1.2).

           The default is _2._2.

      ddddiiiissssppppllllaaaayyyyWWWWaaaarrrrnnnniiiinnnnggggssss ((((_c_l_a_s_s DDDDiiiissssppppllllaaaayyyyWWWWaaaarrrrnnnniiiinnnnggggssss))))
           DDDDiiiissssppppllllaaaayyyy pops up a dialog    box whenever a warning message
           occurs.    Set this resource to _F_a_l_s_e to ignore warning
           messages.

      eeeeddddiiiittttoooorrrrCCCCoooommmmmmmmaaaannnndddd    ((((_c_l_a_s_s eeeeddddiiiittttoooorrrrCCCCoooommmmmmmmaaaannnndddd))))
           Specifies the name of the preferred editor when editing
           image comments.    The default is _x_t_e_r_m -_t_i_t_l_e "_E_d_i_t
           _I_m_a_g_e _C_o_m_m_e_n_t" -_e _v_i %_s.

      ffffoooonnnntttt ((((_c_l_a_s_s FFFFoooonnnnttttLLLLiiiisssstttt))))
           Specifies the name of the preferred font    to use in
           normal formatted    text.  The default is 14 point
           _H_e_l_v_e_t_i_c_a.

      ffffoooonnnntttt[[[[1111----9999]]]] ((((_c_l_a_s_s FFFFoooonnnntttt[[[[1111----9999]]]]))))
           Specifies the name of the preferred font    to use when
           annotating the image window with    text.  The default
           fonts are _f_i_x_e_d,    _v_a_r_i_a_b_l_e, _5_x_8, _6_x_1_0, _7_x_1_3_b_o_l_d,
           _8_x_1_3_b_o_l_d, _9_x_1_5_b_o_l_d, _1_0_x_2_0, and _1_2_x_2_4.  Refer to IIIIMMMMAAAAGGGGEEEE
           AAAANNNNNNNNOOOOTTTTAAAATTTTIIIIOOOONNNN for more details.



     Page 24                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      ffffoooorrrreeeeggggrrrroooouuuunnnndddd ((((_c_l_a_s_s FFFFoooorrrreeeeggggrrrroooouuuunnnndddd))))
           Specifies the preferred color to    use for    text within
           the image window.  The default is black.

      ggggaaaammmmmmmmaaaaCCCCoooorrrrrrrreeeecccctttt ((((_c_l_a_s_s ggggaaaammmmmmmmaaaaCCCCoooorrrrrrrreeeecccctttt))))
           This resource, if true, will lighten or darken an image
           of known    gamma to match the gamma of the    display    (see
           resource    _d_i_s_p_l_a_y_G_a_m_m_a).    The default is True.

      ggggeeeeoooommmmeeeettttrrrryyyy ((((_c_l_a_s_s GGGGeeeeoooommmmeeeettttrrrryyyy))))
           Specifies the preferred size and    position of the    image
           window.    It is not necessarily obeyed by    all window
           managers.

      iiiiccccoooonnnnGGGGeeeeoooommmmeeeettttrrrryyyy ((((_c_l_a_s_s IIIIccccoooonnnnGGGGeeeeoooommmmeeeettttrrrryyyy))))
           Specifies the preferred size and    position of the
           application when    iconified.  It is not necessarily
           obeyed by all window managers.

      iiiiccccoooonnnniiiicccc ((((_c_l_a_s_s    IIIIccccoooonnnniiiicccc))))
           This resource indicates that you    would prefer that the
           application's windows initially not be visible as if
           the windows had be immediately iconified    by you.
           Window managers may choose not to honor the
           application's request.

      mmmmaaaaggggnnnniiiiffffyyyy ((((_c_l_a_s_s MMMMaaaaggggnnnniiiiffffyyyy))))
           specifies an integral factor by which the image should
           be enlarged.  The default is 3.

           This value only affects the magnification window    which
           is invoked with button number 3 after the image is
           displayed.  Refer to BBBBUUUUTTTTTTTTOOOONNNNSSSS for    more details.

      mmmmaaaatttttttteeeeCCCCoooolllloooorrrr ((((_c_l_a_s_s MMMMaaaatttttttteeeeCCCCoooolllloooorrrr))))
           Specify the color of windows.  It is used for the
           backgrounds of windows, menus, and notices.  A 3D
           effect  is achieved  by using highlight and shadow
           colors derived from this    color.    Default    value: #ccc.

      nnnnaaaammmmeeee ((((_c_l_a_s_s NNNNaaaammmmeeee))))
           This resource specifies the name    under which resources
           for the application should be found.  This resource is
           useful in shell aliases to distinguish between
           invocations of an application, without resorting    to
           creating    links to alter the executable file name.  The
           default is the application name.

      ppppeeeennnn[[[[1111----9999]]]] ((((_c_l_a_s_s PPPPeeeennnn[[[[1111----9999]]]]))))
           Specifies the color of the preferred font to use    when
           annotating the image window with    text.  The default
           colors are _b_l_a_c_k, _b_l_u_e, _g_r_e_e_n, _c_y_a_n, _g_r_a_y, _r_e_d,



     Page 25                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



           _m_a_g_e_n_t_a,    _y_e_l_l_o_w,    and _w_h_i_t_e.  Refer to IIIIMMMMAAAAGGGGEEEE AAAANNNNNNNNOOOOTTTTAAAATTTTIIIIOOOONNNN
           for more    details.

      pppprrrriiiinnnnttttCCCCoooommmmmmmmaaaannnndddd ((((_c_l_a_s_s PPPPrrrriiiinnnnttttCCCCoooommmmmmmmaaaannnndddd))))
           This command is executed    whenever PPPPrrrriiiinnnntttt is issued (see
           BBBBUUUUTTTTTTTTOOOONNNNSSSS.     In general, it    is the command to print
           Postscript to your printer.  Default value: llllpppprrrr ----rrrr %%%%ssss.

      sssshhhhaaaarrrreeeeddddMMMMeeeemmmmoooorrrryyyy ((((_c_l_a_s_s SSSShhhhaaaarrrreeeeddddMMMMeeeemmmmoooorrrryyyy))))
           This resource specifies whether display should attempt
           use shared memory for pixmaps.  ImageMagick must    be
           compiled    with shared memory support, and    the display
           must support the    MIT-SHM    extension.  Otherwise, this
           resource    is ignored.  The default is True.

      tttteeeexxxxttttFFFFoooonnnntttt ((((_c_l_a_s_s tttteeeexxxxttttFFFFoooonnnntttt))))
           Specifies the name of the preferred font    to use in
           fixed (typewriter style)    formatted text.     The default
           is 14 point _C_o_u_r_i_e_r.

      ttttiiiittttlllleeee    ((((_c_l_a_s_s TTTTiiiittttlllleeee))))
           This resource specifies the title to be used for    the
           image window.  This information is sometimes used by a
           window manager to provide a header identifying the
           window.    The default is the image file name.

      uuuunnnnddddooooCCCCaaaacccchhhheeee ((((_c_l_a_s_s UUUUnnnnddddooooCCCCaaaacccchhhheeee))))
           Specifies, in mega-bytes, the amount of memory in the
           undo edit cache.     Each time you modify the image    it is
           saved in    the undo edit cache as long as memory is
           available.  You can subsequently    _u_n_d_o one or more of
           these transformations.  The default is 16 mega-bytes.

      uuuusssseeeePPPPiiiixxxxmmmmaaaapppp ((((_c_l_a_s_s UUUUsssseeeePPPPiiiixxxxmmmmaaaapppp))))
           Images are maintained as    a XImage by default.  Set this
           resource    to True    to utilize a server Pixmap instead.
           This option is useful if    your image exceeds the
           dimensions of your server screen    and you    intend to pan
           the image.  Panning is much faster with Pixmaps than
           with a XImage.  Pixmaps are considered a    precious
           resource, use them with discretion.

           To set the geometry of the _M_a_g_n_i_f_y or _P_a_n or window,
           use the _g_e_o_m_e_t_r_y    resource.  For example,    to set the Pan
           window geometry to 256x256, use:

            display.pan.geometry: 256x256


     IIIIMMMMAAAAGGGGEEEE LLLLOOOOAAAADDDDIIIINNNNGGGG
      To select an image to    display, choose    OOOOppppeeeennnn of    the FFFFiiiilllleeee sub-
      menu from the    Command    widget.     A file    browser    is displayed.



     Page 26                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      To choose a particular image file, move the pointer to the
      filename and press any button.  The filename is copied to
      the text window.  Next, press    OOOOppppeeeennnn or    press the RETURN key.
      Alternatively, you can type the image    file name directly
      into the text    window.     To descend directories, choose    a
      directory name and press the button twice quickly.  A
      scrollbar allows a large list    of filenames to    be moved
      through the viewing area if it exceeds the size of the list
      area.

      You can trim the list    of file    names by using shell globbing
      characters.  For example, type ****....jjjjppppgggg to list only files that
      end with ....jjjjppppgggg.

      To select your image from the    X server screen    instead    of
      from a file, Choose GGGGrrrraaaabbbb of the OOOOppppeeeennnn widget.

     VVVVIIIISSSSUUUUAAAALLLL IIIIMMMMAAAAGGGGEEEE DDDDIIIIRRRREEEECCCCTTTTOOOORRRRYYYY
      To create a Visual Image Directory, choose VVVViiiissssuuuuaaaallll DDDDiiiirrrreeeeccccttttoooorrrryyyy
      of the FFFFiiiilllleeee sub-menu from the    Command    widget.     A file
      browser is displayed.     To create a Visual Image Directory
      from all the images in the current directory,    press
      DDDDiiiirrrreeeeccccttttoooorrrryyyy or press the RETURN    key.  Alternatively, you can
      select a set of image    names by using shell globbing
      characters.  For example, type ****....jjjjppppgggg to include only files
      that end with    ....jjjjppppgggg.  To descend directories, choose a
      directory name and press the button twice quickly.  A
      scrollbar allows a large list    of filenames to    be moved
      through the viewing area if it exceeds the size of the list
      area.

      After    you select a set of files, they    are turned into
      thumbnails and tiled onto a single image.  Now move the
      pointer to a particular thumbnail and    press button 3 and
      drag.     Finally, select OOOOppppeeeennnn.    The image represented by the
      thumbnail is displayed at its    full size.  Choose NNNNeeeexxxxtttt    from
      the FFFFiiiilllleeee sub-menu of the Command widget to return to the
      Visual Image Directory.

     IIIIMMMMAAAAGGGGEEEE CCCCUUUUTTTTTTTTIIIINNNNGGGG
      Note that cut    information for    _i_m_a_g_e _w_i_n_d_o_w is    not retained
      for colormapped X server visuals (e.g. _S_t_a_t_i_c_C_o_l_o_r,
      _S_t_a_t_i_c_C_o_l_o_r, _G_r_a_y_S_c_a_l_e, _P_s_e_u_d_o_C_o_l_o_r).     Correct cutting
      behavior may require a _T_r_u_e_C_o_l_o_r or _D_i_r_e_c_t_C_o_l_o_r visual or a
      _S_t_a_n_d_a_r_d _C_o_l_o_r_m_a_p.

      To begin, press choose CCCCuuuutttt of    the EEEEddddiiiitttt sub-menu from the
      Command widget (see CCCCOOOOMMMMMMMMAAAANNNNDDDD WWWWIIIIDDDDGGGGEEEETTTT).    Alternatively, press
      FFFF3333 in    the image window (see KKKKEEEEYYYYBBBBOOOOAAAARRRRDDDD AAAACCCCCCCCEEEELLLLEEEERRRRAAAATTTTOOOORRRRSSSS).

      A small window appears showing the location of the cursor in
      the image window.  You are now in _c_u_t    mode.  In _c_u_t mode,



     Page 27                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      the Command widget has these options:

          Help
          Dismiss

      To define a cut region, press    button 1 and drag.  The    cut
      region is defined by a highlighted rectangle that expands or
      contracts as it follows the pointer.    Once you are satisfied
      with the cut region, release the button.  You    are now    in
      _r_e_c_t_i_f_y mode.     In _r_e_c_t_i_f_y mode, the Command widget has these
      options:

          Cut
          Help
          Dismiss

      You can make adjustments by moving the pointer to one    of the
      cut rectangle    corners, pressing a button, and    dragging.
      Finally, press CCCCuuuutttt to    commit your copy region.  To exit
      without cutting the image, press DDDDiiiissssmmmmiiiissssssss.

     IIIIMMMMAAAAGGGGEEEE CCCCOOOOPPPPYYYYIIIINNNNGGGG
      To begin, press choose CCCCooooppppyyyy of the EEEEddddiiiitttt sub-menu from    the
      Command widget (see CCCCOOOOMMMMMMMMAAAANNNNDDDD WWWWIIIIDDDDGGGGEEEETTTT).    Alternatively, press
      FFFF4444 in    the image window (see KKKKEEEEYYYYBBBBOOOOAAAARRRRDDDD AAAACCCCCCCCEEEELLLLEEEERRRRAAAATTTTOOOORRRRSSSS).

      A small window appears showing the location of the cursor in
      the image window.  You are now in _c_o_p_y mode.    In _c_o_p_y    mode,
      the Command widget has these options:

          Help
          Dismiss

      To define a copy region, press button    1 and drag.  The copy
      region is defined by a highlighted rectangle that expands or
      contracts as it follows the pointer.    Once you are satisfied
      with the copy    region,    release    the button.  You are now in
      _r_e_c_t_i_f_y mode.     In _r_e_c_t_i_f_y mode, the Command widget has these
      options:

          Copy
          Help
          Dismiss

      You can make adjustments by moving the pointer to one    of the
      copy rectangle corners, pressing a button, and dragging.
      Finally, press CCCCooooppppyyyy to commit    your copy region.  To exit
      without copying the image, press DDDDiiiissssmmmmiiiissssssss.

     IIIIMMMMAAAAGGGGEEEE PPPPAAAASSSSTTTTIIIINNNNGGGG
      To begin, press choose PPPPaaaasssstttteeee of the EEEEddddiiiitttt sub-menu from the
      Command widget (see CCCCOOOOMMMMMMMMAAAANNNNDDDD WWWWIIIIDDDDGGGGEEEETTTT).    Alternatively, press



     Page 28                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      FFFF5555 in    the image window (see KKKKEEEEYYYYBBBBOOOOAAAARRRRDDDD AAAACCCCCCCCEEEELLLLEEEERRRRAAAATTTTOOOORRRRSSSS).

      A small window appears showing the location of the cursor in
      the image window. You    are now    in _P_a_s_t_e mode.    To exit
      immediately, press DDDDiiiissssmmmmiiiissssssss.  In _P_a_s_t_e    mode, the Command
      widget has these options:

          Operators
        Over
        In
        Out
        Atop
        Xor
        Plus
        Minus
        Add
        Subtract
        Difference
        Bumpmap
        Replace
        ReplaceRed
        ReplaceGreen
        ReplaceBlue
        ReplaceMatte
          Help
          Dismiss

      Choose a composite operation from the    OOOOppppeeeerrrraaaattttoooorrrrssss sub-menu of
      the Command widget.  How each    operator behaves is described
      below.  _i_m_a_g_e    _w_i_n_d_o_w is the image currently displayed    on
      your X server    and _i_m_a_g_e is the image obtained    with the File
      Browser widget.


      OOOOvvvveeeerrrr The result is the union of the two image    shapes,    with
           _i_m_a_g_e obscuring _i_m_a_g_e _w_i_n_d_o_w in the region of overlap.

      IIIInnnn   The result is simply _i_m_a_g_e cut by the shape of _i_m_a_g_e
           _w_i_n_d_o_w.    None of    the image data of _i_m_a_g_e    _w_i_n_d_o_w is in
           the result.

      OOOOuuuutttt  The resulting image is _i_m_a_g_e with the shape of _i_m_a_g_e
           _w_i_n_d_o_w cut out.

      AAAAttttoooopppp The result is the same shape as image _i_m_a_g_e _w_i_n_d_o_w,
           with _i_m_a_g_e obscuring _i_m_a_g_e _w_i_n_d_o_w where the image
           shapes overlap.    Note this differs from oooovvvveeeerrrr because
           the portion of _i_m_a_g_e outside _i_m_a_g_e _w_i_n_d_o_w's shape does
           not appear in the result.

      XXXXoooorrrr  The result is the image data from both _i_m_a_g_e and    _i_m_a_g_e
           _w_i_n_d_o_w that is outside the overlap region.  The overlap



     Page 29                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



           region is blank.

      PPPPlllluuuussss The result is just the sum of the image data.  Output
           values are cropped to 255 (no overflow).     This
           operation is independent    of the matte channels.

      MMMMiiiinnnnuuuussss
           The result of _i_m_a_g_e - _i_m_a_g_e _w_i_n_d_o_w, with    underflow
           cropped to zero.     The matte channel is ignored (set to
           255, full coverage).

      AAAAdddddddd  The result of _i_m_a_g_e + _i_m_a_g_e _w_i_n_d_o_w, with    overflow
           wrapping    around (_m_o_d 256).

      SSSSuuuubbbbttttrrrraaaacccctttt
           The result of _i_m_a_g_e - _i_m_a_g_e _w_i_n_d_o_w, with    underflow
           wrapping    around (_m_o_d 256).  The aaaadddddddd and ssssuuuubbbbttttrrrraaaacccctttt
           operators can be    used to    perform    reversible
           transformations.

      DDDDiiiiffffffffeeeerrrreeeennnncccceeee
           The result of abs(_i_m_a_g_e - _i_m_a_g_e _w_i_n_d_o_w).     This is
           useful for comparing two    very similar images.

      BBBBuuuummmmppppmmmmaaaapppp
           The result of _i_m_a_g_e _w_i_n_d_o_w  shaded by _i_m_a_g_e.

      RRRReeeeppppllllaaaacccceeee
           The resulting image is _i_m_a_g_e _w_i_n_d_o_w replaced with
           _i_m_a_g_e.  Here the    matte information is ignored.

      RRRReeeeppppllllaaaacccceeeeRRRReeeedddd
           The resulting image is the red layer of _i_m_a_g_e _w_i_n_d_o_w
           replaced    with the red layer of _i_m_a_g_e.  The remaining
           layers remain untouched.

      RRRReeeeppppllllaaaacccceeeeGGGGrrrreeeeeeeennnn
           The resulting image is the green    layer of _i_m_a_g_e _w_i_n_d_o_w
           replaced    with the green layer of    _i_m_a_g_e.    The remaining
           layers remain untouched.

      RRRReeeeppppllllaaaacccceeeeBBBBlllluuuueeee
           The resulting image is the blue layer of    _i_m_a_g_e _w_i_n_d_o_w
           replaced    with the blue layer of _i_m_a_g_e.  The remaining
           layers remain untouched.

      RRRReeeeppppllllaaaacccceeeeMMMMaaaatttttttteeee
           The resulting image is the matte    layer of _i_m_a_g_e _w_i_n_d_o_w
           replaced    with the matte layer of    _i_m_a_g_e.    The remaining
           layers remain untouched.

           The image compositor requires a matte, or alpha channel



     Page 30                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



           in the image for    some operations.  This extra channel
           usually defines a mask which represents a sort of a
           cookie-cutter for the image.  This is the case when
           matte is    255 (full coverage) for    pixels inside the
           shape, zero outside, and    between    zero and 255 on    the
           boundary.  If _i_m_a_g_e does    not have a matte channel, it
           is initialized with 0 for any pixel matching in color
           to pixel    location (0,0),    otherwise 255.    See MMMMAAAATTTTTTTTEEEE
           EEEEDDDDIIIITTTTIIIINNNNGGGG for a method of defining    a matte    channel.

           Note that matte information for _i_m_a_g_e _w_i_n_d_o_w is not
           retained    for colormapped    X server visuals (e.g.
           _S_t_a_t_i_c_C_o_l_o_r, _S_t_a_t_i_c_C_o_l_o_r, _G_r_a_y_S_c_a_l_e, _P_s_e_u_d_o_C_o_l_o_r).
           Correct compositing behavior may    require    a _T_r_u_e_C_o_l_o_r or
           _D_i_r_e_c_t_C_o_l_o_r visual or a _S_t_a_n_d_a_r_d    _C_o_l_o_r_m_a_p.

           Choosing    a composite operator is    optional.  The default
           operator    is _r_e_p_l_a_c_e.  However, you must choose a
           location    to composite your image    and press button 1.
           Press and hold the button before    releasing and an
           outline of the image will appear    to help    you identify
           your location.

           The actual colors of the    pasted image is    saved.
           However,    the color that appears in _i_m_a_g_e    _w_i_n_d_o_w may be
           different.  For example,    on a monochrome    screen _i_m_a_g_e
           _w_i_n_d_o_w will appear black    or white even though your
           pasted image may    have many colors.  If the image    is
           saved to    a file it is written with the correct colors.
           To assure the correct colors are    saved in the final
           image, any _P_s_e_u_d_o_C_l_a_s_s image is promoted    to _D_i_r_e_c_t_C_l_a_s_s
           (see mmmmiiiiffffffff((((5555))))).  To force    a _P_s_e_u_d_o_C_l_a_s_s image to remain
           _P_s_e_u_d_o_C_l_a_s_s, use    ----ccccoooolllloooorrrrssss.

     IIIIMMMMAAAAGGGGEEEE CCCCRRRROOOOPPPPPPPPIIIINNNNGGGG
      To begin, press choose CCCCrrrroooopppp of the TTTTrrrraaaannnnssssffffoooorrrrmmmm sub-menu    from
      the Command widget (see CCCCOOOOMMMMMMMMAAAANNNNDDDD WWWWIIIIDDDDGGGGEEEETTTT).  Alternatively,
      press    [[[[ in the image window (see KKKKEEEEYYYYBBBBOOOOAAAARRRRDDDD AAAACCCCCCCCEEEELLLLEEEERRRRAAAATTTTOOOORRRRSSSS).

      A small window appears showing the location of the cursor in
      the image window.  You are now in _c_r_o_p mode.    In _c_r_o_p    mode,
      the Command widget has these options:

          Help
          Dismiss

      To define a cropping region, press button 1 and drag.     The
      cropping region is defined by    a highlighted rectangle    that
      expands or contracts as it follows the pointer.  Once    you
      are satisfied    with the cropping region, release the button.
      You are now in _r_e_c_t_i_f_y mode.    In _r_e_c_t_i_f_y mode, the Command
      widget has these options:



     Page 31                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



          Crop
          Help
          Dismiss

      You can make adjustments by moving the pointer to one    of the
      cropping rectangle corners, pressing a button, and dragging.
      Finally, press CCCCrrrroooopppp to commit    your cropping region.  To exit
      without cropping the image, press DDDDiiiissssmmmmiiiissssssss.

     IIIIMMMMAAAAGGGGEEEE CCCCHHHHOOOOPPPPPPPPIIIINNNNGGGG
      An image is chopped interactively.  There is no command line
      argument to chop an image.  To begin,    choose CCCChhhhoooopppp of the
      TTTTrrrraaaannnnssssffffoooorrrrmmmm sub-menu from the Command widget (see CCCCOOOOMMMMMMMMAAAANNNNDDDD
      WWWWIIIIDDDDGGGGEEEETTTT).  Alternatively, press ]]]] in the image    window (see
      KKKKEEEEYYYYBBBBOOOOAAAARRRRDDDD AAAACCCCCCCCEEEELLLLEEEERRRRAAAATTTTOOOORRRRSSSS).

      You are now in _C_h_o_p mode.  To    exit immediately, press
      DDDDiiiissssmmmmiiiissssssss.  In _C_h_o_p mode, the Command widget has these
      options:

          Direction
        horizontal
        vertical
          Help
          Dismiss

      If the you choose the    hhhhoooorrrriiiizzzzoooonnnnttttaaaallll direction (this is the
      default), the    area of    the image between the two horizontal
      endpoints of the chop    line is    removed.  Otherwise, the area
      of the image between the two vertical    endpoints of the chop
      line is removed.

      Select a location within the image window to begin your
      chop,    press and hold any button.  Next, move the pointer to
      another location in the image.  As you move a    line will
      connect the initial location and the pointer.     When you
      release the button, the area within the image    to chop    is
      determined by    which direction    you choose from    the Command
      widget.

      To cancel the    image chopping,    move the pointer back to the
      starting point of the    line and release the button.

     IIIIMMMMAAAAGGGGEEEE RRRROOOOTTTTAAAATTTTIIIIOOOONNNN
      Press    the //// key to rotate the    image 90 degrees or \\\\ to
      rotate -90 degrees (see KKKKEEEEYYYYBBBBOOOOAAAARRRRDDDD AAAACCCCCCCCEEEELLLLEEEERRRRAAAATTTTOOOORRRRSSSS).  To
      interactively    choose the degree of rotation, choose
      RRRRoooottttaaaatttteeee............ of the PPPPiiiixxxxeeeellll TTTTrrrraaaannnnssssffffoooorrrrmmmm submenu from    the Command
      Widget (see CCCCOOOOMMMMMMMMAAAANNNNDDDD WWWWIIIIDDDDGGGGEEEETTTT).    Alternatively, press * in the
      image    window (see KKKKEEEEYYYYBBBBOOOOAAAARRRRDDDD AAAACCCCCCCCEEEELLLLEEEERRRRAAAATTTTOOOORRRRSSSS).

      A small horizontal line is drawn next    to the pointer.     You



     Page 32                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      are now in _r_o_t_a_t_e mode.  To exit immediately,    press DDDDiiiissssmmmmiiiissssssss.
      In _r_o_t_a_t_e mode, the Command widget has these options:

          Pixel Color
        black
        blue
        cyan
        green
        gray
        red
        magenta
        yellow
        white
        Browser...
          Direction
        horizontal
        vertical
          Crop
        false
        true
          Sharpen
        false
        true
          Help
          Dismiss

      Choose a background color from the PPPPiiiixxxxeeeellll CCCCoooolllloooorrrr sub-menu.
      Additional background    colors can be specified    with the color
      browser.  You    can change the menu colors by setting the X
      resources ppppeeeennnn1111 through ppppeeeennnn9999.    Refer to XXXX RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS for more
      details.

      If you choose    the color browser and press GGGGrrrraaaabbbb, you can
      select the background    color by moving    the pointer to the
      desired color    on the screen and press    any button. The
      transparent color updates the    image matte channel and    is
      useful for image compositing.

      Choose a point in the    image window and press this button and
      hold.     Next, move the    pointer    to another location in the
      image.  As you move a    line connects the initial location and
      the pointer.    When you release the button, the degree    of
      image    rotation is determined by the slope of the line    you
      just drew.  The slope    is relative to the direction you
      choose from the DDDDiiiirrrreeeeccccttttiiiioooonnnn sub-menu of    the Command widget.

      To cancel the    image rotation,    move the pointer back to the
      starting point of the    line and release the button.

     IIIIMMMMAAAAGGGGEEEE AAAANNNNNNNNOOOOTTTTAAAATTTTIIIIOOOONNNN
      An image is annotated    interactively.    There is no command
      line argument    to annotate an image.  To begin, choose



     Page 33                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      _A_n_n_o_t_a_t_e of the IIIImmmmaaaaggggeeee    EEEEddddiiiitttt sub-menu from the Command widget
      (see CCCCOOOOMMMMMMMMAAAANNNNDDDD WWWWIIIIDDDDGGGGEEEETTTT).     Alternatively,    press _a    in the image
      window (see KKKKEEEEYYYYBBBBOOOOAAAARRRRDDDD AAAACCCCCCCCEEEELLLLEEEERRRRAAAATTTTOOOORRRRSSSS).

      A small window appears showing the location of the cursor in
      the image window.  You are now in _a_n_n_o_t_a_t_e mode.  To exit
      immediately, press DDDDiiiissssmmmmiiiissssssss.  In _a_n_n_o_t_a_t_e mode, the Command
      widget has these options:

          Font Name
        fixed
        variable
        5x8
        6x10
        7x13bold
        8x13bold
        9x15bold
        10x20
        12x24
        Browser...
          Font Color
        black
        blue
        cyan
        green
        gray
        red
        magenta
        yellow
        white
        transparent
        Browser...
          Box Color
        black
        blue
        cyan
        green
        gray
        red
        magenta
        yellow
        white
        transparent
        Browser...
          Rotate Text
        -90
        -45
        -30
        0
        30
        45
        90



     Page 34                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



        180
        Dialog...
          Help
          Dismiss

      Choose a font    name from the FFFFoooonnnntttt NNNNaaaammmmeeee    sub-menu.  Additional
      font names can be specified with the font browser.  You can
      change the menu names    by setting the X resources ffffoooonnnntttt1111
      through ffffoooonnnntttt9999.  Refer    to XXXX RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS for more    details.

      Choose a font    color from the FFFFoooonnnntttt CCCCoooolllloooorrrr sub-menu.
      Additional font colors can be    specified with the color
      browser.  You    can change the menu colors by setting the X
      resources ppppeeeennnn1111 through ppppeeeennnn9999.    Refer to XXXX RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS for more
      details.

      If you select    the color browser and press GGGGrrrraaaabbbb, you can
      choose the font color    by moving the pointer to the desired
      color    on the screen and press    any button.

      If you choose    to rotate the text, choose Rotate Text from
      the menu and select an angle.     Typically you will only want
      to rotate one    line of    text at    a time.     Depending on the
      angle    you choose, subsequent lines may end up    overwriting
      each other.

      Choosing a font and its color    is optional.  The default font
      is _f_i_x_e_d and the default color is _b_l_a_c_k.  However, you must
      choose a location to begin entering text and press button 1.
      An underscore    character will appear at the location of the
      pointer.  The    cursor changes to a pencil to indicate you are
      in _t_e_x_t mode.     To exit immediately, press DDDDiiiissssmmmmiiiissssssss.

      In _t_e_x_t mode,    any key    presses    will display the character at
      the location of the underscore and advance the underscore
      cursor.  Enter your text and once completed press DDDDiiiissssmmmmiiiissssssss to
      finish your image annotation.     To correct errors press BBBBAAAACCCCKKKK
      SSSSPPPPAAAACCCCEEEE.  To delete an entire line of text, press DDDDEEEELLLLEEEETTTTEEEE.  Any
      text that exceeds the    boundaries of the image    window is
      automatically    continued onto the next    line.

      The actual color you request for the font is saved in    the
      image.  However, the color that appears in your image    window
      may be different.  For example, on a monochrome screen the
      text will appear black or white even if you choose the color
      red as the font color.  However, the image saved to a    file
      with ----wwwwrrrriiiitttteeee is written with red lettering.  To assure    the
      correct color    text in    the final image, any _P_s_e_u_d_o_C_l_a_s_s image
      is promoted to _D_i_r_e_c_t_C_l_a_s_s (see mmmmiiiiffffffff((((5555))))).  To    force a
      _P_s_e_u_d_o_C_l_a_s_s image to remain _P_s_e_u_d_o_C_l_a_s_s, use ----ccccoooolllloooorrrrssss.

     IIIIMMMMAAAAGGGGEEEE CCCCOOOOMMMMPPPPOOOOSSSSIIIITTTTIIIINNNNGGGG



     PPPPaaaaggggeeee 33335555                        ((((pppprrrriiiinnnntttteeeedddd 11112222////11117777////99998888))))






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      An image composite is    created    interactively.    There is no
      command line argument    to composite an    image.    To begin,
      choose CCCCoooommmmppppoooossssiiiitttteeee of the IIIImmmmaaaaggggeeee    EEEEddddiiiitttt from the Command widget
      (see CCCCOOOOMMMMMMMMAAAANNNNDDDD WWWWIIIIDDDDGGGGEEEETTTT).     Alternatively,    press _x    in the image
      window (see KKKKEEEEYYYYBBBBOOOOAAAARRRRDDDD AAAACCCCCCCCEEEELLLLEEEERRRRAAAATTTTOOOORRRRSSSS).

      First    a popup    window is displayed requesting you to enter an
      image    name.  Press CCCCoooommmmppppoooossssiiiitttteeee,    GGGGrrrraaaabbbb or    type a file name.
      Press    CCCCaaaannnncccceeeellll if you choose not to create a composite image.
      When you choose GGGGrrrraaaabbbb,    move the pointer to the    desired    window
      and press any    button.

      If the CCCCoooommmmppppoooossssiiiitttteeee image does not have any matte information,
      you are informed and the file    browser    is displayed again.
      Enter    the name of a mask image.  The image is    typically
      grayscale and    the same size as the composite image.  If the
      image    is not grayscale, it is    converted to grayscale and the
      resulting intensities    are used as matte information.

      A small window appears showing the location of the cursor in
      the image window. You    are now    in _c_o_m_p_o_s_i_t_e mode.  To exit
      immediately, press DDDDiiiissssmmmmiiiissssssss.  In _c_o_m_p_o_s_i_t_e mode, the Command
      widget has these options:

          Operators
        over
        in
        out
        atop
        xor
        plus
        minus
        add
        subtract
        difference
        bumpmap
        replace
          Blend
          Displace
          Help
          Dismiss

      Choose a composite operation from the    OOOOppppeeeerrrraaaattttoooorrrrssss sub-menu of
      the Command widget.  How each    operator behaves is described
      below.  _i_m_a_g_e    _w_i_n_d_o_w is the image currently displayed    on
      your X server    and _i_m_a_g_e is the image obtained    with the File
      Browser widget.


      oooovvvveeeerrrr The result is the union of the two image    shapes,    with
           _i_m_a_g_e obscuring _i_m_a_g_e _w_i_n_d_o_w in the region of overlap.




     Page 36                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      iiiinnnn   The result is simply _i_m_a_g_e cut by the shape of _i_m_a_g_e
           _w_i_n_d_o_w.    None of    the image data of _i_m_a_g_e    _w_i_n_d_o_w is in
           the result.

      oooouuuutttt  The resulting image is _i_m_a_g_e with the shape of _i_m_a_g_e
           _w_i_n_d_o_w cut out.

      aaaattttoooopppp The result is the same shape as image _i_m_a_g_e _w_i_n_d_o_w,
           with _i_m_a_g_e obscuring _i_m_a_g_e _w_i_n_d_o_w where the image
           shapes overlap.    Note this differs from oooovvvveeeerrrr because
           the portion of _i_m_a_g_e outside _i_m_a_g_e _w_i_n_d_o_w's shape does
           not appear in the result.

      xxxxoooorrrr  The result is the image data from both _i_m_a_g_e and    _i_m_a_g_e
           _w_i_n_d_o_w that is outside the overlap region.  The overlap
           region is blank.

      pppplllluuuussss The result is just the sum of the image data.  Output
           values are cropped to 255 (no overflow).     This
           operation is independent    of the matte channels.

      mmmmiiiinnnnuuuussss
           The result of _i_m_a_g_e - _i_m_a_g_e _w_i_n_d_o_w, with    underflow
           cropped to zero.     The matte channel is ignored (set to
           255, full coverage).

      aaaadddddddd  The result of _i_m_a_g_e + _i_m_a_g_e _w_i_n_d_o_w, with    overflow
           wrapping    around (_m_o_d 256).

      ssssuuuubbbbttttrrrraaaacccctttt
           The result of _i_m_a_g_e - _i_m_a_g_e _w_i_n_d_o_w, with    underflow
           wrapping    around (_m_o_d 256).  The aaaadddddddd and ssssuuuubbbbttttrrrraaaacccctttt
           operators can be    used to    perform    reversible
           transformations.

      ddddiiiiffffffffeeeerrrreeeennnncccceeee
           The result of abs(_i_m_a_g_e - _i_m_a_g_e _w_i_n_d_o_w).     This is
           useful for comparing two    very similar images.

      bbbbuuuummmmppppmmmmaaaapppp
           The result of _i_m_a_g_e _w_i_n_d_o_w  shaded by _i_m_a_g_e.

      rrrreeeeppppllllaaaacccceeee
           The resulting image is _i_m_a_g_e _w_i_n_d_o_w replaced with
           _i_m_a_g_e.  Here the    matte information is ignored.

           The image compositor requires a matte, or alpha channel
           in the image for    some operations.  This extra channel
           usually defines a mask which represents a sort of a
           cookie-cutter for the image.  This is the case when
           matte is    255 (full coverage) for    pixels inside the
           shape, zero outside, and    between    zero and 255 on    the



     Page 37                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



           boundary.  If _i_m_a_g_e does    not have a matte channel, it
           is initialized with 0 for any pixel matching in color
           to pixel    location (0,0),    otherwise 255.    See MMMMAAAATTTTTTTTEEEE
           EEEEDDDDIIIITTTTIIIINNNNGGGG for a method of defining    a matte    channel.

           If you choose bbbblllleeeennnndddd, the    composite operator becomes
           oooovvvveeeerrrr.  The _i_m_a_g_e    matte channel percent transparency is
           initialized to _f_a_c_t_o_r.  The _i_m_a_g_e _w_i_n_d_o_w    is initialized
           to (_1_0_0-_f_a_c_t_o_r).     Where factor is the value you specify
           in the Dialog widget.

           DDDDiiiissssppppllllaaaacccceeee    shifts the image pixels    as defined by a
           displacement map.  With this option, _i_m_a_g_e is used as a
           displacement map.  Black, within    the displacement map,
           is a maximum positive displacement.  White is a maximum
           negative    displacement and middle    gray is    neutral.  The
           displacement is scaled to determine the pixel shift.
           By default, the displacement applies in both the
           horizontal and vertical directions.  However, if    you
           specify a _m_a_s_k, _i_m_a_g_e is    the horizontal X displacement
           and _m_a_s_k    the vertical Y displacement.

           Note that matte information for _i_m_a_g_e _w_i_n_d_o_w is not
           retained    for colormapped    X server visuals (e.g.
           _S_t_a_t_i_c_C_o_l_o_r, _S_t_a_t_i_c_C_o_l_o_r, _G_r_a_y_S_c_a_l_e, _P_s_e_u_d_o_C_o_l_o_r).
           Correct compositing behavior may    require    a _T_r_u_e_C_o_l_o_r or
           _D_i_r_e_c_t_C_o_l_o_r visual or a _S_t_a_n_d_a_r_d    _C_o_l_o_r_m_a_p.

           Choosing    a composite operator is    optional.  The default
           operator    is _r_e_p_l_a_c_e.  However, you must choose a
           location    to composite your image    and press button 1.
           Press and hold the button before    releasing and an
           outline of the image will appear    to help    you identify
           your location.

           The actual colors of the    composite image    is saved.
           However,    the color that appears in _i_m_a_g_e    _w_i_n_d_o_w may be
           different.  For example,    on a monochrome    screen _i_m_a_g_e
           _w_i_n_d_o_w will appear black    or white even though your
           composited image    may have many colors.  If the image is
           saved to    a file it is written with the correct colors.
           To assure the correct colors are    saved in the final
           image, any _P_s_e_u_d_o_C_l_a_s_s image is promoted    to _D_i_r_e_c_t_C_l_a_s_s
           (see mmmmiiiiffffffff((((5555))))).  To force    a _P_s_e_u_d_o_C_l_a_s_s image to remain
           _P_s_e_u_d_o_C_l_a_s_s, use    ----ccccoooolllloooorrrrssss.

     CCCCOOOOLLLLOOOORRRR EEEEDDDDIIIITTTTIIIINNNNGGGG
      Changing the the color of a set of pixels is performed
      interactively.  There    is no command line argument to edit a
      pixel.  To begin, choose CCCCoooolllloooorrrr from the IIIImmmmaaaaggggeeee    EEEEddddiiiitttt submenu
      of the Command widget    (see CCCCOOOOMMMMMMMMAAAANNNNDDDD WWWWIIIIDDDDGGGGEEEETTTT).  Alternatively,
      press    _c in the image window (see KKKKEEEEYYYYBBBBOOOOAAAARRRRDDDD AAAACCCCCCCCEEEELLLLEEEERRRRAAAATTTTOOOORRRRSSSS).



     Page 38                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      A small window appears showing the location of the cursor in
      the image window. You    are now    in _c_o_l_o_r _e_d_i_t mode.  To    exit
      immediately, press DDDDiiiissssmmmmiiiissssssss.  In _c_o_l_o_r    _e_d_i_t mode, the Command
      widget has these options:

          Pixel Color
        black
        blue
        cyan
        green
        gray
        red
        magenta
        yellow
        white
        Browser...
          Method
        point
        replace
        floodfill
        reset
          Delta
        0
        1
        2
        4
        8
        16
        32
        Browser...
          Undo
          Help
          Dismiss

      Choose a pixel color from the    PPPPiiiixxxxeeeellll CCCCoooolllloooorrrr sub-menu.
      Additional pixel colors can be specified with    the color
      browser.  You    can change the menu colors by setting the X
      resources ppppeeeennnn1111 through ppppeeeennnn9999.    Refer to XXXX RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS for more
      details.

      Next,    choose a color editing method from the MMMMeeeetttthhhhoooodddd sub-menu
      of the Command widget.  The ppppooooiiiinnnntttt method recolors any    pixel
      selected with    the pointer unless the button is released.
      The rrrreeeeppppllllaaaacccceeee method recolors any pixel    that matches the color
      of the pixel you select with a button    press.    FFFFllllooooooooddddffffiiiillllllll
      recolors any pixel that matches the color of the pixel you
      select with a    button press and is a neighbor.     Finally rrrreeeesssseeeetttt
      changes the entire image to the designated color.

      Now press button 1 to    select a pixel within the image    window
      to change its    color.    Additional pixels may be recolored as
      prescribed by    the method you choose.    You can    recolor



     Page 39                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      additional pixels by increasing the Delta value.  The    Delta
      value    is first added then subtracted from the    red, green,
      and blue of the target color.     Any pixels within the range
      is also recolored.

      If the Magnify widget    is mapped, it can be helpful in
      positioning your pointer within the image (refer to button
      2).  Alternatively you can select a pixel to recolor from
      within the Magnify widget.  Move the pointer to the Magnify
      widget and position the pixel    with the cursor    control    keys.
      Finally, press a button to recolor the selected pixel    (or
      pixels).

      The actual color you request for the pixels is saved in the
      image.  However, the color that appears in your image    window
      may be different.  For example, on a monochrome screen the
      pixel    will appear black or white even    if you choose the
      color    red as the pixel color.     However, the image saved to a
      file with ----wwwwrrrriiiitttteeee is written with red pixels.    To assure the
      correct color    text in    the final image, any _P_s_e_u_d_o_C_l_a_s_s image
      is promoted to _D_i_r_e_c_t_C_l_a_s_s (see mmmmiiiiffffffff((((5555))))).  To    force a
      _P_s_e_u_d_o_C_l_a_s_s image to remain _P_s_e_u_d_o_C_l_a_s_s, use ----ccccoooolllloooorrrrssss.

     MMMMAAAATTTTTTTTEEEE EEEEDDDDIIIITTTTIIIINNNNGGGG
      Matte    information within an image is useful for some
      operations such as image compositing (See IIIIMMMMAAAAGGGGEEEE
      CCCCOOOOMMMMPPPPOOOOSSSSIIIITTTTIIIINNNNGGGG).     This extra channel usually defines a mask
      which    represents a sort of a cookie-cutter for the image.
      This is the case when    matte is 255 (full coverage) for
      pixels inside    the shape, zero    outside, and between zero and
      255 on the boundary.

      Setting the matte information    in an image is done
      interactively.  There    is no command line argument to edit a
      pixel.  To begin, and    choose _M_a_t_t_e of    the IIIImmmmaaaaggggeeee EEEEddddiiiitttt sub-
      menu from the    Command    widget (see CCCCOOOOMMMMMMMMAAAANNNNDDDD WWWWIIIIDDDDGGGGEEEETTTT).
      Alternatively, press _m in the    image window (see KKKKEEEEYYYYBBBBOOOOAAAARRRRDDDD
      AAAACCCCCCCCEEEELLLLEEEERRRRAAAATTTTOOOORRRRSSSS).

      A small window appears showing the location of the cursor in
      the image window. You    are now    in _m_a_t_t_e _e_d_i_t mode.  To    exit
      immediately, press DDDDiiiissssmmmmiiiissssssss.  In _m_a_t_t_e    _e_d_i_t mode, the Command
      widget has these options:

          Method
        point
        replace
        floodfill
        reset
          Delta
        0
        1



     Page 40                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



        2
        4
        8
        16
        32
        Browser...
          Matte
          Undo
          Help
          Dismiss

      Choose a matte editing method    from the MMMMeeeetttthhhhoooodddd    sub-menu of
      the Command widget.  The ppppooooiiiinnnntttt method    changes    the matte
      value    of the any pixel selected with the pointer until the
      button is released.  The rrrreeeeppppllllaaaacccceeee method changes the matte
      value    of any pixel that matches the color of the pixel you
      select with a    button press.  FFFFllllooooooooddddffffiiiillllllll changes the matte
      value    of any pixel that matches the color of the pixel you
      select with a    button press and is a neighbor.    Finally    rrrreeeesssseeeetttt
      changes the entire image to the designated matte value.

      Choose MMMMaaaatttttttteeee VVVVaaaalllluuuueeee and a dialog appears requesting a matte
      value.  Enter    a value    between    0 and 255.  This value is
      assigned as the matte    value of the selected pixel or pixels.

      Now, press any button    to select a pixel within the image
      window to change its matte value.  You can change the    matte
      value    of additional pixels by    increasing the Delta value.
      The Delta value is first added then subtracted from the red,
      green, and blue of the target    color.    Any pixels within the
      range    also have their    matte value updated.

      If the Magnify widget    is mapped, it can be helpful in
      positioning your pointer within the image (refer to button
      2).  Alternatively you can select a pixel to change the
      matte    value from within the Magnify widget.  Move the
      pointer to the Magnify widget    and position the pixel with
      the cursor control keys.  Finally, press a button to change
      the matte value of the selected pixel    (or pixels).

      Matte    information is only valid in a _D_i_r_e_c_t_C_l_a_s_s image.
      Therefore, any _P_s_e_u_d_o_C_l_a_s_s image is promoted to _D_i_r_e_c_t_C_l_a_s_s
      (see mmmmiiiiffffffff((((5555))))).  Note that matte information for _P_s_e_u_d_o_C_l_a_s_s
      is not retained for colormapped X server visuals (e.g.
      _S_t_a_t_i_c_C_o_l_o_r, _S_t_a_t_i_c_C_o_l_o_r, _G_r_a_y_S_c_a_l_e, _P_s_e_u_d_o_C_o_l_o_r) unless you
      immediately save your    image to a file    (refer to WWWWrrrriiiitttteeee).
      Correct matte    editing    behavior may require a _T_r_u_e_C_o_l_o_r or
      _D_i_r_e_c_t_C_o_l_o_r visual or    a _S_t_a_n_d_a_r_d _C_o_l_o_r_m_a_p.

     IIIIMMMMAAAAGGGGEEEE DDDDRRRRAAAAWWWWIIIINNNNGGGG
      An image is drawn upon interactively.     There is no command
      line argument    to draw    on an image.  To begin,    choose _D_r_a_w of



     Page 41                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      the IIIImmmmaaaaggggeeee EEEEddddiiiitttt sub-menu from the Command widget (see CCCCOOOOMMMMMMMMAAAANNNNDDDD
      WWWWIIIIDDDDGGGGEEEETTTT).  Alternatively, press _d in the image    window (see
      KKKKEEEEYYYYBBBBOOOOAAAARRRRDDDD AAAACCCCCCCCEEEELLLLEEEERRRRAAAATTTTOOOORRRRSSSS).

      The cursor changes to    a crosshair to indicate    you are    in
      _d_r_a_w mode.  To exit immediately, press DDDDiiiissssmmmmiiiissssssss.  In _d_r_a_w
      mode,    the Command widget has these options:

          Primitive
        point
        line
        rectangle
        fill rectangle
        ellipse
        fill ellipse
        polygon
        fill polygon
          Color
        black
        blue
        cyan
        green
        gray
        red
        magenta
        yellow
        white
        transparent
        Browser...
          Stipple",
        Brick",
        Diagonal",
        Scales",
        Vertical",
        Wavy",
        Translucent",
        Opaque",
        Open...",
          Width
        1
        2
        4
        8
        16
        Dialog...
          Undo
          Help
          Dismiss

      Choose a drawing primitive from the PPPPrrrriiiimmmmiiiittttiiiivvvveeee    sub-menu.

      Next,    choose a color from the    CCCCoooolllloooorrrr sub-menu.     Additional



     Page 42                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      colors can be    specified with the color browser.  You can
      change the menu colors by setting the    X resources ppppeeeennnn1111
      through ppppeeeennnn9999.     Refer to XXXX RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS for more details.

      If you choose    the color browser and press GGGGrrrraaaabbbb, you can
      select the primitive color by    moving the pointer to the
      desired color    on the screen and press    any button.  The
      transparent color updates the    image matte channel and    is
      useful for image compositing.,

      Choose a stipple, if appropriate, from the Stipple sub-menu.
      Additional stipples can be specified with the    file browser.
      Stipples obtained from the file browser must be on disk in
      the X11 bitmap format.

      Choose a line    width from the WWWWiiiiddddtttthhhh sub-menu.    To choose a
      specific width select    the Dialog widget.

      Choose a point in the    image window and press button 1    and
      hold.     Next, move the    pointer    to another location in the
      image.  As you move, a line connects the initial location
      and the pointer.  When you release the button, the image is
      updated with the primitive you just drew.  For polygons, the
      image    is updated when    you press and release the button
      without moving the pointer.

      To cancel image drawing, move    the pointer back to the
      starting point of the    line and release the button.

     RRRREEEEGGGGIIIIOOOONNNN OOOOFFFF IIIINNNNTTTTEEEERRRREEEESSSSTTTT
      To begin, press choose RRRReeeeggggiiiioooonnnn    ooooffff IIIInnnntttteeeerrrreeeesssstttt of the TTTTrrrraaaannnnssssffffoooorrrrmmmm
      sub-menu from    the Command widget (see    CCCCOOOOMMMMMMMMAAAANNNNDDDD    WWWWIIIIDDDDGGGGEEEETTTT).
      Alternatively, press RRRR in the    image window (see KKKKEEEEYYYYBBBBOOOOAAAARRRRDDDD
      AAAACCCCCCCCEEEELLLLEEEERRRRAAAATTTTOOOORRRRSSSS).

      A small window appears showing the location of the cursor in
      the image window.  You are now in _r_e_g_i_o_n _o_f _i_n_t_e_r_e_s_t mode.
      In _r_e_g_i_o_n _o_f _i_n_t_e_r_e_s_t    mode, the Command widget has these
      options:

          Help
          Dismiss

      To define a region of    interest, press    button 1 and drag.
      The region of    interest is defined by a highlighted rectangle
      that expands or contracts as it follows the pointer.    Once
      you are satisfied with the region of interest, release the
      button.  You are now in _a_p_p_l_y    mode.  In _a_p_p_l_y    mode the
      Command widget has these options:

          File
        Save...



     Page 43                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



        Print...
          Edit
        Undo
        Redo
          Transform
        Flip
        Flop
        Rotate Right
        Rotate Left
          Enhance
        Hue...
        Saturation...
        Brightness...
        Gamma...
        Spiff
        Dull
        Equalize
        Normalize
        Negate
        Grayscale
        Quantize...
          Effects
        Despeckle
        Emboss
        Reduce Noise
        Add Noise
        Sharpen...
        Blur...
        Threshold...
        Edge Detect...
        Spread...
        Shade...
        Raise...
        Segment...
          F/X
        Swirl...
        Implode...
        Wave...
        Oil Painting...
        Charcoal Drawing...
          Miscellany
        Image Info
        Zoom Image
        Show Preview...
        Show Histogram
        Show Matte
          Help
          Dismiss

      You can make adjustments to the region of interest by    moving
      the pointer to one of    the rectangle corners, pressing    a
      button, and dragging.     Finally, choose an image processing



     Page 44                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      technique from the Command widget.  You can choose more than
      one image processing technique to apply to an    area.
      Alternatively, you can move the region of interest before
      applying another image processing technique.    To exit, press
      DDDDiiiissssmmmmiiiissssssss.

     IIIIMMMMAAAAGGGGEEEE PPPPAAAANNNNNNNNIIIINNNNGGGG
      When an image    exceeds    the width or height of the X server
      screen, ddddiiiissssppppllllaaaayyyy maps a small panning icon.  The rectangle
      within the panning icon shows    the area that is currently
      displayed in the the image window.  To _p_a_n about the image,
      press    any button and drag the    pointer    within the panning
      icon.     The pan rectangle moves with the pointer and the
      image    window is updated to reflect the location of the
      rectangle within the panning icon.  When you have selected
      the area of the image    you wish to view, release the button.

      Use the arrow    keys to    pan the    image one pixel    up, down,
      left,    or right within    the image window.

      The panning icon is withdrawn    if the image becomes smaller
      than the dimensions of the X server screen.

     IIIIMMMMAAAAGGGGEEEE SSSSEEEEGGGGMMMMEEEENNNNTTTTAAAATTTTIIIIOOOONNNN
      Use ----sssseeeeggggmmmmeeeennnntttt to segment an image by analyzing    the histograms
      of the color components and identifying units    that are
      homogeneous with the fuzzy c-means technique.     The scale-
      space    filter analyzes    the histograms of the three color
      components of    the image and identifies a set of classes.
      The extents of each class is used to coarsely    segment    the
      image    with thresholding.  The    color associated with each
      class    is determined by the mean color    of all pixels within
      the extents of a particular class.  Finally, any
      unclassified pixels are assigned to the closest class    with
      the fuzzy c-means technique.

      The fuzzy c-Means algorithm can be summarized    as follows:

           o Build a histogram, one    for each color component of
           the image.

           o For each histogram, successively apply    the scale-
           space filter and    build an interval tree of zero
           crossings in the    second derivative at each scale.
           Analyze this scale-space    ``fingerprint''    to determine
           which peaks or valleys in the histogram are most
           predominant.

           o The fingerprint defines intervals on the axis of the
           histogram.  Each    interval contains either a minima or a
           maxima in the original signal.  If each color component
           lies within the maxima interval,    that pixel is



     Page 45                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



           considered ``classified'' and is    assigned an unique
           class number.

           o Any pixel that    fails to be classified in the above
           thresholding pass is classified using the fuzzy c-Means
           technique.  It is assigned to one of the    classes
           discovered in the histogram analysis phase.

      The fuzzy c-Means technique attempts to cluster a pixel by
      finding the local minima of the generalized within group sum
      of squared error objective function.    A pixel    is assigned to
      the closest class of which the fuzzy membership has a
      maximum value.

      For additional information see

           Young Won Lim, Sang Uk Lee, "On The Color Image
           Segmentation Algorithm Based on the Thresholding    and
           the Fuzzy c-Means Techniques", Pattern Recognition,
           Volume 23, Number 9, pages 935-952, 1990.

     UUUUSSSSEEEERRRR PPPPRRRREEEEFFFFEEEERRRREEEENNNNCCCCEEEESSSS
      Preferences affect the default behavior of ddddiiiissssppppllllaaaayyyy((((1111)))).  The
      preferences are either true or false and are stored in your
      home directory as ....ddddiiiissssppppllllaaaayyyyrrrrcccc:

      ddddiiiissssppppllllaaaayyyy iiiimmmmaaaaggggeeee    cccceeeennnntttteeeerrrreeeedddd oooonnnn aaaa bbbbaaaacccckkkkddddrrrroooopppp
           This backdrop covers the    entire workstation screen and
           is useful for hiding other X window activity while
           viewing the image.   The    color of the backdrop is
           specified as the    background color.  Refer to XXXX
           RRRREEEESSSSOOOOUUUURRRRCCCCEEEESSSS for details.

      ccccoooonnnnffffiiiirrrrmmmm oooonnnn pppprrrrooooggggrrrraaaammmm eeeexxxxiiiitttt
           Ask for a confirmation before exiting the ddddiiiissssppppllllaaaayyyy((((1111))))
           program.

      ccccoooorrrrrrrreeeecccctttt iiiimmmmaaaaggggeeee    ffffoooorrrr ddddiiiissssppppllllaaaayyyy ggggaaaammmmmmmmaaaa
           If the image has    a known    gamma, the gamma is corrected
           to match    that of    the X server (see the X    resource
           ddddiiiissssppppllllaaaayyyyGGGGaaaammmmmmmmaaaa).

      aaaappppppppllllyyyy    FFFFllllooooyyyydddd////SSSStttteeeeiiiinnnnbbbbeeeerrrrgggg    eeeerrrrrrrroooorrrr ddddiiiiffffffffuuuussssiiiioooonnnn    ttttoooo iiiimmmmaaaaggggeeee
           The basic strategy of dithering is to trade intensity
           resolution for spatial resolution by averaging the
           intensities of several neighboring pixels.  Images
           which suffer from severe    contouring when    reducing
           colors can be improved with this    perference.

      uuuusssseeee aaaa    sssshhhhaaaarrrreeeedddd ccccoooolllloooorrrrmmmmaaaapppp    ffffoooorrrr ccccoooolllloooorrrrmmmmaaaappppppppeeeedddd    XXXX vvvviiiissssuuuuaaaallllssss
           This option only    applies    when the default X server
           visual is _P_s_e_u_d_o_C_o_l_o_r or    _G_r_a_y_S_c_a_l_e.  Refer to ----vvvviiiissssuuuuaaaallll



     Page 46                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



           for more    details.  By default, a    shared colormap    is
           allocated.  The image shares colors with    other X
           clients.     Some image colors could be approximated,
           therefore your image may    look very different than
           intended.  Choose PPPPrrrriiiivvvvaaaatttteeee and the image colors appear
           exactly as they are defined.  However, other clients
           may go _t_e_c_h_n_i_c_o_l_o_r when the image colormap is
           installed.

      ddddiiiissssppppllllaaaayyyy iiiimmmmaaaaggggeeeessss aaaassss aaaannnn XXXX sssseeeerrrrvvvveeeerrrr    ppppiiiixxxxmmmmaaaapppp
           Images are maintained as    a XImage by default.  Set this
           resource    to True    to utilize a server Pixmap instead.
           This option is useful if    your image exceeds the
           dimensions of your server screen    and you    intend to pan
           the image.  Panning is much faster with Pixmaps than
           with a XImage.  Pixmaps are considered a    precious
           resource, use them with discretion.

     EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
      ddddiiiissssppppllllaaaayyyy
           To get the default host,    display    number,    and screen.

     SSSSEEEEEEEE AAAALLLLSSSSOOOO
      aaaannnniiiimmmmaaaatttteeee((((1111)))),,,, iiiimmmmppppoooorrrrtttt((((1111)))),,,, mmmmoooonnnnttttaaaaggggeeee((((1111)))),,,, mmmmooooggggrrrriiiiffffyyyy((((1111)))),,,, mmmmoooossssaaaaiiiicccc((((1111)))),,,,
      ccccoooonnnnvvvveeeerrrrtttt((((1111)))),,,, ccccoooommmmbbbbiiiinnnneeee((((1111)))),,,, xxxxttttpppp((((1111))))

     CCCCOOOOPPPPYYYYRRRRIIIIGGGGHHHHTTTT
      Copyright 1998 E. I. du Pont de Nemours and Company

      Permission is    hereby granted,    free of    charge,    to any person
      obtaining a copy of this software and    associated
      documentation    files ("ImageMagick"), to deal in ImageMagick
      without restriction, including without limitation the    rights
      to use, copy,    modify,    merge, publish,    distribute,
      sublicense, and/or sell copies of ImageMagick, and to    permit
      persons to whom the ImageMagick is furnished to do so,
      subject to the following conditions:

      The above copyright notice and this permission notice    shall
      be included in all copies or substantial portions of
      ImageMagick.

      The software is provided "as is", without warranty of    any
      kind,    express    or implied, including but not limited to the
      warranties of    merchantability, fitness for a particular
      purpose and noninfringement.    In no event shall E. I.    du
      Pont de Nemours and Company be liable    for any    claim, damages
      or other liability, whether in an action of contract,    tort
      or otherwise,    arising    from, out of or    in connection with
      ImageMagick or the use or other dealings in ImageMagick.

      Except as contained in this notice, the name of the E. I. du



     Page 47                        (printed 12/17/98)






     ddddiiiissssppppllllaaaayyyy((((1111))))         IIIImmmmaaaaggggeeeeMMMMaaaaggggiiiicccckkkk ((((1111    FFFFeeeebbbb 1111999999995555))))        ddddiiiissssppppllllaaaayyyy((((1111))))



      Pont de Nemours and Company shall not    be used    in advertising
      or otherwise to promote the sale, use    or other dealings in
      ImageMagick without prior written authorization from the E.
      I. du    Pont de    Nemours    and Company.

     AAAACCCCKKKKNNNNOOOOWWWWLLLLEEEEDDDDGGGGEEEEMMMMEEEENNNNTTTTSSSS
      The MIT X Consortium for making network transparent graphics
      a reality.

      Peder    Langlo,    Hewlett    Packard, Norway, made hundreds of
      suggestions and bug reports.    Without    Peder, ImageMagick
      would    not be nearly as useful    as it is today.

      Rod Bogart and John W. Peterson, University of Utah.    Image
      compositing is loosely based on _r_l_e_c_o_m_p of the Utah Raster
      Toolkit.

      Michael Halle, Spatial Imaging Group at MIT, for the initial
      implementation of Alan Paeth's image rotation    algorithm.

      David    Pensak,    E. I. du Pont de Nemours and Company, for
      providing a computing    environment that made this program
      possible.

      Paul Raveling, USC Information Sciences Institute. The
      spatial subdivision color reduction algorithm    is based on
      his _I_m_g software.

     AAAAUUUUTTTTHHHHOOOORRRRSSSS
      John Cristy, E.I. du Pont de Nemours and Company
      Incorporated
























     Page 48                        (printed 12/17/98)